Creators#
Manage creators (influencers) with social media accounts across six platforms.
Authentication required
Authorization header. See the Authentication guide for setup instructions.GET /v1/creators#
Retrieve a paginated list of creators for an organization.
GET /v1/creators?page_index=0&page_size=25&organization_id=org_123
Authorization: Bearer {token}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| pageIndex | integer | Required | Zero-based page index for pagination. |
| pageSize | integer | Required | Number of items per page (1-100). |
| organizationId | string (UUID) | Required | Organization identifier. |
| searchTerm | string | — | Free-text search term to filter results (max 200 characters). |
| sortBy | string | — | Column name to sort by. |
| sortDirection | 'asc' | 'desc' | — | Sort direction: ascending or descending. |
| activityId | string (UUID) | — | Filter by activity identifier. |
| role | 'person' | 'community' | 'brand_partner' | — | Filter by creator role. |
Response#
Returns { items, totalCount, facets } with paginated results.
Underlying SDK method: bw.creators.list(params)
GET /v1/creators/stats#
Aggregate statistics for creators matching the given filters.
GET /v1/creators/stats?organization_id=org_123
Authorization: Bearer {token}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| activityId | string (UUID) | — | Filter by activity identifier. |
| role | 'person' | 'community' | 'brand_partner' | — | Filter by creator role. |
| searchTerm | string | — | Free-text search term to filter results (max 200 characters). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators.stats(params)
GET /v1/creators/:id#
Retrieve a single creator by ID with full details and social accounts.
GET /v1/creators/:id
Authorization: Bearer {token}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Creator identifier. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators({ id })
POST /v1/creators#
Create a new creator (influencer) within an organization. Required: organizationId, name. Optional: email, role (person/community/brand_partner), country (2-letter ISO code), notes.
POST /v1/creators
Authorization: Bearer {token}
Content-Type: application/json
{
"organization_id": "org_123",
"name": "My Campaign"
}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| name | string | Required | Creator display name. |
string | null | — | Creator contact email. | |
| role | 'person' | 'community' | 'brand_partner' | null | — | Creator role: "person", "community", or "brand_partner". |
| country | string | null | — | Two-letter ISO 3166-1 country code. |
| notes | string | null | — | Internal notes about this creator (max 2,000 characters). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators.create(params)
PATCH /v1/creators/:id#
Update a creator profile including role, country, and internal notes.
PATCH /v1/creators/:id
Authorization: Bearer {token}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Creator identifier to update. |
| name | string | — | Updated creator name (1-255 characters). |
string | null | — | Updated contact email. | |
| role | 'person' | 'community' | 'brand_partner' | null | — | Updated role: "person", "community", or "brand_partner". |
| country | string | null | — | Updated two-letter ISO 3166-1 country code. |
| notes | string | null | — | Updated internal notes (max 2,000 characters). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators.update(params)
DELETE /v1/creators/:id#
Permanently delete a creator and all associated data.
DELETE /v1/creators/:id
Authorization: Bearer {token}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Creator identifier to delete. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators.delete(params)
Destructive action
POST /v1/creators/social-accounts/connect#
Connect a social media account to a creator via profile URL.
POST /v1/creators/social-accounts/connect
Authorization: Bearer {token}
Content-Type: application/json
{
"creator_id": "con_abc123",
"platform": "instagram",
"profile_url": "..."
}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| creatorId | string (UUID) | Required | Creator identifier to connect the account to. |
| platform | 'instagram' | 'youtube' | 'tiktok' | 'twitter' | 'linkedin' | 'reddit' | Required | Social media platform. |
| profileUrl | string | Required | Profile URL or username for the social media account (max 2,048 characters). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators.socialAccounts.connect(params)
Supported platforms
DELETE /v1/creators/:creatorId/social-accounts/:platform/:accountId#
Disconnect a social media account from a creator.
DELETE /v1/creators/:creatorId/social-accounts/:platform/:accountId
Authorization: Bearer {token}Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| creatorId | string (UUID) | Required | Creator identifier to disconnect the account from. |
| accountId | string (UUID) | Required | Social media account identifier to disconnect. |
| platform | 'instagram' | 'youtube' | 'tiktok' | 'twitter' | 'linkedin' | 'reddit' | Required | Social media platform. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators.socialAccounts.disconnect(params)