TOtoksta
Creator Lists

Create a creator list

Create a creator list. SaaS workspace entitlement required — dedicated API keys receive 403. name is required.

post/v1/creator-lists

Request

Request body

namestring required

List name (required).

descriptionstring
is_privateboolean

Defaults to true.

tagsstring[]
platform'linkedin' | 'youtube' | 'twitter'

Optional platform.

public_creator_idsstring[]

Public creator UUIDs to seed the list.

private_creator_idsstring[]

Private creator UUIDs to seed the list.

Example request

{
  "name": "Shortlist — Dev influencers",
  "platform": "linkedin",
  "is_private": true
}

Response

Creator list created.

successtrue required
dataobject required

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

Example response

{
  "success": true,
  "data": {
    "creator_list": {
      "id": "11112222-3333-4444-5555-666677778888",
      "name": "Shortlist — Dev influencers",
      "description": null,
      "is_private": true,
      "tags": [],
      "platform": "linkedin",
      "creator_counts": {
        "public_creators": 0,
        "private_creators": 0,
        "total": 0
      },
      "created_at": "2026-05-29T10:00:00Z",
      "updated_at": "2026-05-29T10:00:00Z"
    }
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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