Create Empty List
POST /lists/create-empty
Create a list with nothing in it, to fill later.
SEND AN idempotency_key. Without one a retried request makes a second
empty list, and a duplicate list is harder to notice than a failed call.
Authorizations
Parameters
Header Parameters
Request Body required
Create a list with nothing in it, to fill later.
idempotency_key is worth using: without one, a retried create makes a
SECOND empty list, and a duplicate list is harder to notice than a failed
request.
object
A dynamic list re-runs its query; a static one keeps what it is given.
Where the list comes from, e.g. csv.
What the list holds. The wire name is type; the app’s field is type_ because type is a Python builtin, and the alias keeps the wire name identical to the app’s.
Responses
201
Successful Response
object
An open envelope for a list, a capability map or a job result.
Open because several of these return the whole Audience, whose shape
carries per-source metadata that differs between an uploaded file, a
dynamic query and a master list - and grows with them.
object
422
Validation Error