creators#
Browse creators resource actions that can be discovered, described, and executed through the Brandwave MCP server.
Capability flow
discover-brandwave-capabilities, describe-brandwave-action, and execute-brandwave-action to work with these actions.list-creators#
Retrieve a paginated list of creators for an organization.
Example prompt#
List all creators in my organization.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-creator-stats#
Aggregate statistics for creators matching the given filters.
Example prompt#
Show me the details for this creator stats.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-creator#
Retrieve a single creator by ID with full details and social accounts.
Example prompt#
Show me the details for this creator.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Creator identifier. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.creators({ id })
create-creator#
Create a new creator (influencer) within an organization. Required: organizationId, name. Optional: email, role (person/community/brand_partner), country (2-letter ISO code), notes.
Example prompt#
Create a new creator.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)
update-creator#
Update a creator profile including role, country, and internal notes.
Example prompt#
Update the creator.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-creator#
Permanently delete a creator and all associated data.
Example prompt#
Delete this creator.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
connect-creator-social-account#
Connect a social media account to a creator via profile URL.
Example prompt#
Connect the creator social account.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
disconnect-social-account#
Disconnect a social media account from a creator.
Example prompt#
Remove the social account.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)