Skip to main content
POST
/
creators
Create a creator
curl --request POST \
  --url https://api.creatoraudit.com/v2/creators \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "is_active": true,
  "metadata": {}
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "type": "creator",
    "is_active": false,
    "metadata": {},
    "accounts_summary": {
      "total": 0,
      "platforms": {},
      "total_followers": 0
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string | null

Optional client-supplied unique key for retry-safe POSTs. Best-effort in-process dedup over a 10-minute window. Multi-replica deployments will need a shared store before this is load-bearing across all writes.

Body

application/json
​
name
string
required

Creator name (1–255 chars).

Required string length: 1 - 255
​
is_active
boolean
default:true

Create as active (default true).

​
metadata
Metadata · object

Optional key/value tags (≤20 keys, ≤255 chars each).

Response

Successful Response

​
data
CreatorResponse · object
required