Save Search as a static List

Snapshots the people currently matching the given Search into a brand-new static List (returned as its wrapper Search). The membership is frozen at snapshot time — later changes to the source search or underlying data do not affect the list.

The snapshot always runs in a background worker (Core::CreateListFromSearchWorker) backed by a Task; the response includes the task_id the caller can poll. On completion the task deep-links to the new wrapper Search.

Gated behind the show_list_searches client setting — lists are only useful as audiences when that setting is on.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
number
required

The ID of the source search to snapshot

Body Params
string

Name for the new list (defaults to the source search name)

boolean

Discard the source search after a successful snapshot (SearchBuilder new-audience path only)

Response
200

A successful response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!