Creators

Manage the people or entities that produce content in your workspace.

List creators

GET /api/v1/creators

Returns all creators in your workspace.

Example

curl -H "Authorization: Bearer findclix_..." \
  "https://findclix.com/api/v1/creators"

Response

{
  "success": true,
  "data": [
    {
      "id": "abc-123",
      "name": "John Doe",
      "avatar_url": "https://example.com/avatar.jpg",
      "profile_url": "https://instagram.com/johndoe",
      "created_at": "2026-01-01T00:00:00.000Z",
      "media_count": 12,
      "category_count": 2
    }
  ]
}

Interactive reference

List creators

GET

/creators

Playground

Authorization

ApiKeyAuth

Samples

---

Get creator

GET /api/v1/creators/:id

Returns a single creator by ID.

Example

curl -H "Authorization: Bearer findclix_..." \
  "https://findclix.com/api/v1/creators/abc-123"

Response

{
  "success": true,
  "data": {
    "id": "abc-123",
    "name": "John Doe",
    "avatar_url": "https://example.com/avatar.jpg",
    "profile_url": "https://instagram.com/johndoe",
    "created_at": "2026-01-01T00:00:00.000Z",
      "media_count": 12,
      "category_count": 2
  }
}

Interactive reference

Get creator

GET

/creators/{id}

Playground

Authorization

ApiKeyAuth

Variables

Key

Value

id*

Samples

---

Create creator

POST /api/v1/creators

Creates a new creator. If a profile_url is provided (Instagram, YouTube, etc.), the avatar is fetched automatically.

Request body

Field	Type	Required	Description
name	string	Yes	Creator's display name
profile_url	string	No	Social profile URL (used to fetch avatar)

Example

curl -X POST -H "Authorization: Bearer findclix_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Jane Smith", "profile_url": "https://instagram.com/janesmith"}' \
  "https://findclix.com/api/v1/creators"

Response

{
  "success": true,
  "data": {
    "id": "c1234567-89ab-cdef-0123-456789abcdef",
    "name": "Jane Smith",
    "avatar_url": "https://example.com/avatar.jpg",
    "profile_url": "https://instagram.com/janesmith",
    "created_at": "2026-09-09T12:00:00.000Z",
    "media_count": 0,
    "category_count": 0
  }
}

WARNING

Creator creation is subject to your plan's limits. The Free plan allows 1 creator — upgrade under Settings → Billing to add more.

Interactive reference

Create a creator

POST

/creators

Playground

Authorization

ApiKeyAuth

Body

Samples