Creators

Reminder: All queries on this page require the WORKSPACE-ID header. See Getting Started for setup.

A Creator represents a person — an influencer or content creator your brand is working with. Each creator has a profile in your workspace CRM with custom attributes (name, email, location, labels, etc.) and can have multiple social accounts linked to them across platforms.

Via the API, you can query creators by name, email, location, label, or any other attribute. This is the same data you see in the Creators page in the Archive UI.

Important: The API only returns creators already in your workspace CRM. It does not provide access to the Creator Search database (the global discovery tool).

Learn more: Difference Between Creators and Social Profiles

Object

Creator

A person in your CRM

creatorscreator

Hierarchy

Parent

Custom attributes

full_namelocationemailsphone_numberslabelsgenderagecollaboration_statusfavouritenotescategory

Example

→ Sarah = 1 creator

Use when

Looking up CRM data, filtering by attributes

1 → many

Object

Social Profile

A platform account

socialProfile

Hierarchy

Child — belongs to one creator

Platforms

InstagramTikTokYouTube

Platform data

accountNamefullNamefollowersfollowingverifiedproAccountprivateavataroriginalUrlemailphoneNumbers

Example

→ Sarah's Instagram + Sarah's TikTok = 2 social profiles

Use when

Looking up platform stats by handle

Quick rule: If you need CRM-level data — name, email, labels, relationship status — query the creator. If you need platform stats for a specific handle — followers, verified status — query the socialProfile. Every Social Profile carries a reference back to its Creator.

To look up a specific social account by handle, see the Social Profiles page.

All Creator fields

Field	Type	Description
`id`	ID	Unique creator identifier
`customAttributes`	JSON	All CRM attributes: `full_name`, `location`, `emails`, `phone_numbers`, `labels`, `gender`, `age`, `collaboration_status` (Relationship Status), `favourite`, `notes`, `category`. Note: `phone_numbers` here is manually entered in Archive — it may differ from `phoneNumbers` on the creator’s Social Profile, which is pulled from the platform.
`socialProfiles`	Array	All social profiles linked to this creator — see Social Profiles for the full list of profile fields

SELECT fields like gender, age, and labels return UUIDs, not readable names. Use customAttributeSchemas(entity: CREATOR) to map UUIDs to labels. See Custom Attributes.

Creator queries

List creators in your workspace

The first parameter defaults to 20 if not specified. To get more results, set first up to a maximum of 100, or use pagination to fetch additional pages.


query ListCreators {
  creators(first: 20) {
    nodes {
      id
      customAttributes
      socialProfiles {
        accountName
        provider
        followers
        verified
      }
    }
    pageInfo { hasNextPage endCursor }
    totalCount
  }
}

Example response:


{
  "data": {
    "creators": {
      "totalCount": 1284,
      "pageInfo": { "hasNextPage": true, "endCursor": "eyJpZCI6Ii4uLiJ9" },
      "nodes": [
        {
          "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "customAttributes": {
            "full_name": "Laura Méndez",
            "location": "Miami, United States",
            "age": "82b05d3f-c262-40e7-bdcb-6544496f978d",
            "gender": "17a79434-ed12-46d7-9aea-33806bfa1725",
            "emails": ["contact@lauramendez.com"],
            "phone_numbers": ["+1 305 555 0100"],
            "labels": [],
            "collaboration_status": "840bfa06-e02d-4083-af43-c3b9777fffcc",
            "favourite": false,
            "notes": "Top performer Q1 2026",
            "category": []
          },
          "socialProfiles": [
            { "accountName": "lauramendez", "provider": "INSTAGRAM", "followers": 312000, "verified": false },
            { "accountName": "lauramendez.style", "provider": "TIKTOK", "followers": 890000, "verified": false }
          ]
        },
        "... 19 more creators"
      ]
    }
  }
}

Note: SELECT fields like age and gender return internal option IDs (UUIDs), not readable labels. See Custom Attributes to learn how to map them.

Using with AI:

“Show me all creators in my workspace with their social profiles and follower counts” “How many creators do I have in total?”

Search creator by name


query CreatorByName {
  creators(
    first: 5
    customAttributeConditions: [
      { field: "full_name", operator: CONTAINS, type: TEXT, value: "Laura" }
    ]
  ) {
    totalCount
    nodes {
      id
      customAttributes
      socialProfiles { accountName provider followers }
    }
  }
}

Example response:


{
  "data": {
    "creators": {
      "totalCount": 2,
      "nodes": [
        {
          "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "customAttributes": {
            "full_name": "Laura Méndez",
            "location": "Miami, United States"
          },
          "socialProfiles": [
            { "accountName": "lauramendez", "provider": "INSTAGRAM", "followers": 312000 }
          ]
        }
      ]
    }
  }
}

Using with AI:

“Find the creator named Laura” “Search for a creator whose name contains Méndez”

Search creator by email


query CreatorByEmail {
  creators(
    first: 5
    customAttributeConditions: [
      { field: "emails", operator: CONTAINS, type: TEXT, value: "lauramendez" }
    ]
  ) {
    totalCount
    nodes {
      id
      customAttributes
      socialProfiles { accountName provider }
    }
  }
}

Example response:


{
  "data": {
    "creators": {
      "totalCount": 1,
      "nodes": [
        {
          "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "customAttributes": {
            "full_name": "Laura Méndez",
            "emails": ["contact@lauramendez.com"]
          },
          "socialProfiles": [
            { "accountName": "lauramendez", "provider": "INSTAGRAM" }
          ]
        }
      ]
    }
  }
}

Note: Even though emails is a TEXT_LIST field in the schema, use type: TEXT with operator: CONTAINS to search within the list.

Using with AI:

“Find the creator with email contact@lauramendez.com” “Search for a creator by email”

Search creator by location


query CreatorsByLocation {
  creators(
    first: 20
    customAttributeConditions: [
      { field: "location", operator: CONTAINS, type: TEXT, value: "United States" }
    ]
  ) {
    totalCount
    nodes {
      id
      customAttributes
      socialProfiles { accountName provider followers }
    }
  }
}

Example response:


{
  "data": {
    "creators": {
      "totalCount": 347,
      "nodes": [
        {
          "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "customAttributes": {
            "full_name": "Laura Méndez",
            "location": "Miami, United States"
          },
          "socialProfiles": [
            { "accountName": "lauramendez", "provider": "INSTAGRAM", "followers": 312000 }
          ]
        },
        "... 19 more creators"
      ]
    }
  }
}

Using with AI:

“Find all creators located in the United States” “Show me creators based in New York” “List all creators in the UK”

Search creator by label

Labels are custom tags you can apply to creators in the Archive UI. To filter by label, you need the label’s UUID — get it first from customAttributeSchemas:


query GetLabelSchemas {
  customAttributeSchemas(entity: CREATOR) {
    key
    name
    type
    options { id name }
  }
}

Find the entry with key: "labels" and copy the id of the label you want to filter by. Then:


query CreatorsByLabel {
  creators(
    first: 20
    customAttributeConditions: [
      { field: "labels", operator: CONTAINS, type: MULTIPLE_SELECT, value: "<label-uuid>" }
    ]
  ) {
    totalCount
    nodes {
      id
      customAttributes
      socialProfiles { accountName provider followers }
    }
  }
}

Example response:


{
  "data": {
    "creators": {
      "totalCount": 42,
      "nodes": [
        {
          "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "customAttributes": {
            "full_name": "Laura Méndez",
            "labels": ["8f1a2b3c-d4e5-6789-abcd-ef0123456789"]
          },
          "socialProfiles": [
            { "accountName": "lauramendez", "provider": "INSTAGRAM", "followers": 312000 }
          ]
        },
        "... 19 more creators"
      ]
    }
  }
}

Labels are stored as UUIDs in customAttributes.labels. Always run customAttributeSchemas first to map UUIDs to readable names. Label options are workspace-specific — the UUIDs will differ between workspaces.

Using with AI:

“Find all creators with the label ‘VIP’” “Show me creators tagged as ‘Gifted’” “List all creators that have any label assigned”

Get a single creator


query GetCreator {
  creator(id: "f1a2b3c4-d5e6-7890-abcd-ef1234567890") {
    id
    customAttributes
    socialProfiles {
      accountName
      provider
      followers
      verified
    }
  }
}

Example response:


{
  "data": {
    "creator": {
      "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "customAttributes": {
        "full_name": "Laura Méndez",
        "location": "Miami, United States",
        "emails": ["contact@lauramendez.com"],
        "phone_numbers": []
      },
      "socialProfiles": [
        { "accountName": "lauramendez", "provider": "INSTAGRAM", "followers": 312000, "verified": false },
        { "accountName": "lauramendez.style", "provider": "TIKTOK", "followers": 890000, "verified": false }
      ]
    }
  }
}

Using with AI:

“Get me the full profile for creator Laura Méndez” “Show me all social profiles linked to this creator”

To look up platform data (followers, verified status, etc.) for a specific social account, use the Social Profiles page.

Creators

Creators vs. Social Profiles

All Creator fields

Creator queries

List creators in your workspace

Search creator by name

Search creator by email

Search creator by location

Search creator by label

Get a single creator