Conversion sources#

See how an AI assistant can help with conversion sources in Brandwave, including example prompts and the details it may ask for.

Using your AI assistant

Connect to the Brandwave MCP server, then ask your AI assistant in natural language. It will choose the right Brandwave task and ask for any details it needs.

List conversion sources#

List conversion sources with pagination, search, and sorting.

Reads dataSafe to repeat

Example prompt#

text

List all conversion sources in my organization.

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).
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.

What you'll get back#

Returns { items, totalCount, facets } with paginated results.

Get conversion source#

Retrieve a single conversion source by ID.

Reads dataSafe to repeat

Example prompt#

text

Show me the details for this conversion source.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Conversion source identifier.

What you'll get back#

Returns { data } with the result.

Create conversion source#

Create a new conversion source with a marketing channel category for tracking attribution.

Example prompt#

text

Create a new conversion source.

Details to provide#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
name	`string`	Required	Conversion source name.
type	`'hdyhau' \| 'promo_code' \| 'tracking_link'`	Required	Attribution method type.
category	`'organic_social' \| 'podcast' \| 'events' \| 'paid' \| 'referral' \| 'other'`	Required	Marketing channel category.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit' \| null`	—	Social media platform for this conversion source.
creatorId	`string (UUID)`	—	Creator associated with this source.
campaignId	`string (UUID)`	—	Campaign associated with this source.
code	`string`	—	Promo code or tracking code (max 255 characters).
url	`string (URL)`	—	Tracking URL for link-based attribution (max 2,048 characters).

What you'll get back#

Returns { data } with the result.

Update conversion source#

Update a conversion source attribution type, category, social media channel, creator or campaign association, promo code, or tracking URL.

Example prompt#

text

Update the conversion source.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Conversion source identifier to update.
name	`string`	—	Updated name (1-255 characters).
type	`'hdyhau' \| 'promo_code' \| 'tracking_link'`	—	Updated attribution type.
category	`'organic_social' \| 'podcast' \| 'events' \| 'paid' \| 'referral' \| 'other'`	—	Updated category.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit' \| null`	—	Updated social media platform.
creatorId	`string (UUID) \| null`	—	Updated creator association.
campaignId	`string (UUID) \| null`	—	Updated campaign association.
code	`string \| null`	—	Updated promo/tracking code (max 255 characters).
url	`string (URL) \| null`	—	Updated tracking URL (max 2,048 characters).
isActive	`boolean`	—	Whether this source is active.

What you'll get back#

Returns { data } with the result.

Delete conversion source#

Permanently delete a conversion source and disassociate its conversions.

Changes data

Example prompt#

text

Delete this conversion source.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Conversion source identifier to delete.

What you'll get back#

Returns { data } with the result.

Cascading effect

Deleting a conversion source removes the source attribution from all linked conversions. The conversion records themselves are preserved.