Creators#
See how an AI assistant can help with creators in Brandwave, including example prompts and the details it may ask for.
Using your AI assistant
List creators#
Retrieve a paginated list of creators for a workspace, ordered by name, totals, or efficiency.
Tool name: list_creators. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
List all creators in my workspace.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| pageIndex | integer | Required | Zero-based page index for pagination. |
| pageSize | integer | Required | Number of items per page (1-100). |
| workspaceId | string (UUID) | Required | Workspace identifier. |
| searchTerm | string | — | Free-text search term to filter results (max 200 characters). |
| sortBy | 'name' | 'createdAt' | 'activitiesCount' | 'totalFollowersCount' | 'impressions' | 'engagement' | 'spend' | 'cpe' | 'cpm' | — | Creator field 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. |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get creator stats#
Aggregate statistics for creators matching the given filters.
Tool name: get_creator_stats. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Give me a summary of my creator performance.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace 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). |
What you'll get back#
Returns { data, _meta } with the result.
Get creator#
Retrieve a single creator by ID with full details and social accounts.
Tool name: get_creator. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this creator.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Creator identifier. |
What you'll get back#
Returns { data, _meta } with the result.
Create creator#
Create a new creator (influencer) within a workspace. Required: workspaceId, name. Optional: email, role (person/community/brand_partner), country (2-letter ISO code), notes.
Tool name: create_creator. Protocol hints: readOnlyHint=false, destructiveHint=false, idempotentHint=false, openWorldHint=false.
Example prompt#
Create a new creator.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace 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 | — | Private notes about this creator (max 2,000 characters). |
What you'll get back#
Returns { data, _meta } with the result.
Update creator#
Update a creator profile including role, country, and private notes.
Tool name: update_creator. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Update the creator.Details to provide#
| 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 private notes (max 2,000 characters). |
What you'll get back#
Returns { data, _meta } with the result.
Delete creator#
Permanently delete a creator and all associated data.
Tool name: delete_creator. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Delete this creator.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Creator identifier to delete. |
What you'll get back#
Returns { data, _meta } with the result.
This changes data
Link creator social profile#
Link a social profile URL or username to an existing creator in an authorized Brandwave workspace for marketing measurement. Adds a Brandwave association and may start background collection of public profile details and metrics. Public social profiles discovered in the profile biography may also be linked and collected. Supports Instagram, YouTube, TikTok, X/Twitter, LinkedIn, and Reddit. Reuses an existing association; retrying failed collection may start another background job. Returns a connection receipt and any collection-delay warning, not completed metrics. Does not authenticate as the social account owner, modify the social profile, publish posts, or send messages.
Tool name: connect_creator_social_account. Protocol hints: readOnlyHint=false, destructiveHint=false, idempotentHint=false, openWorldHint=true.
Example prompt#
Connect this creator’s Instagram account.Details to provide#
| 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). |
What you'll get back#
Returns { data, _meta } with the result.
Supported platforms
Disconnect social account#
Disconnect a social media account from a creator.
Tool name: disconnect_social_account. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Disconnect this social account from the creator.Details to provide#
| 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. |
What you'll get back#
Returns { data, _meta } with the result.