Sign in
Lists

Create a list

Upload a list of creator handles + emails. Two paths: JSON body OR multipart CSV (file field name file, columns creator_name required + email optional). Returned list_id is what callers pass to automations as lists_selected.

post/lists

Headers

Idempotency-Keystring nullable
X-Dry-Runstring nullable

Request body

namestring required

Human-readable list name shown in the portal.

descriptionstring nullable
creator_handlesstring[]

TikTok handles, with or without leading '@'. Deduplicated case-insensitively at insert time.

creator_emailsstring[]

Email addresses. Deduplicated case-insensitively at insert time.

Response

Successful Response

Changes