Conversion sources#

Manage conversion sources (HDYHAU surveys, UTM links, etc.) that attribute conversions to marketing activities.

List conversion sources#

List conversion sources with pagination, search, and sorting.

typescript

const { items, totalCount, facets } = await bw.conversionSources.list({
  pageIndex: 0,
  pageSize: 25,
  organizationId: 'org_123',
});

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.

Response#

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

Get conversion source#

Retrieve a single conversion source by ID.

typescript

const { data } = await bw.conversionSources({ id: 'abc-123' });

Parameters#

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

Response#

Returns { data } with the result.

Create conversion source#

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

typescript

const { data } = await bw.conversionSources.create({
  organizationId: 'org_123',
  name: 'My Campaign',
  type: 'instagram_post',
  category: '...',
});

Parameters#

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

Response#

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.

typescript

const { data } = await bw.conversionSources.update({
  id: 'abc-123',
});

Parameters#

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.

Response#

Returns { data } with the result.

Delete conversion source#

Permanently delete a conversion source and disassociate its conversions.

typescript

const { data } = await bw.conversionSources.delete({
  id: 'abc-123',
});

Parameters#

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

Response#

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.