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

No recorded changes to this endpoint across all 1 revision of this API.