TOtoksta
Creator Lists

Save creators to a list

Add creators to an existing creator list. SaaS workspace entitlement required. The {id} path parameter must be the list UUID. This endpoint only saves to an existing list — create one first with POST /v1/creator-lists. creator_ids (≥1 valid UUID, max 100) is required.

post/v1/creator-lists/{id}/creators

Request

Path parameters

idstring required

Creator list UUID.

Request body

creator_idsstring[] required

Creator UUIDs to add (1-100).

creator_source'public' | 'private'

Whether IDs are public or private creators. Defaults to public.

Example request

{
  "creator_ids": [
    "f0e1d2c3-b4a5-4678-9abc-def012345678"
  ],
  "creator_source": "public"
}

Response

Creators saved to the list.

successtrue required
dataobject required

Operation payload. See the example for the exact field structure.

Example response

{
  "success": true,
  "data": {
    "list_id": "11112222-3333-4444-5555-666677778888",
    "creator_source": "public",
    "requested_count": 1,
    "added_count": 1,
    "total_items": 1
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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