REreacherapp
Lists

Create a list

Changed on

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

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/lists
  • Auth
    API key in header x-api-key and API key in header x-shop-id

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

  • 291230805105Revision changes
    • warning

      added the new active enum value to the / response property for the response status

    • warning

      added the new archived enum value to the / response property for the response status