Create list

Create a new list with the specified type and source.

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

Organization ID.

uuid
required

Project ID.

string
required

List name.

string
required

Kind of identifier the list holds. Identifier lists: hem, email, uid2, eid, ip, maid. Record lists: contact, account, domain, zipcode, phone.

Deliberately not constrained to that list. The column is stored as given and the API does not enforce a set, so a list created by an integration carries whatever type that integration reported. Those eleven are what is in use today, not a guarantee. Match the ones you handle and pass the rest through rather than rejecting them.

string
required

Where the list came from. Supplied directly: upload, csv_upload, import, manual. Produced by an export run: export. CRM sync: salesforce, hubspot. DSP integration: delivrdsp, delivrdsp_events, delivrdsp_uid2.

Unconstrained for the same reason as type, and this is the column it has actually happened to: several of the values above reached production through an integration before any document named them. Treat an unrecognized value as data rather than as an error.

string

List description.

uuid

Integration ID (for integration-synced lists).

string

External identifier from the source system.

mapping
object

Column mapping configuration for file imports.

boolean
Defaults to false

Whether this list is used for identity resolution.

boolean
Defaults to false

Whether this list is used for intent tracking.

Responses

401

Missing or invalid authentication.

500

Internal server error.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json