Conversions#

Track conversion events attributed to influencer marketing activities.

Authentication required

All endpoints require a Bearer token in the Authorization header. See the Authentication guide for setup instructions.

GET /v1/conversions#

List conversion events with pagination, search, and sorting.

bash

GET /v1/conversions?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.
sourceId	`string (UUID)`	—	Filter by conversion source identifier.

Response#

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

Underlying SDK method: bw.conversions.list(params)

GET /v1/conversions/:id#

Retrieve a single conversion by ID.

bash

GET /v1/conversions/:id
Authorization: Bearer {token}

Parameters#

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

Response#

Returns { data } with the result.

Underlying SDK method: bw.conversions({ id })

POST /v1/conversions#

Record a new conversion event attributed to a conversion source, with optional external reference for deduplication and metadata.

bash

POST /v1/conversions
Authorization: Bearer {token}
Content-Type: application/json

{
  "organization_id": "org_123",
  "source_id": "...",
  "converted_at": "..."
}

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
sourceId	`string (UUID)`	Required	Conversion source this event is attributed to.
convertedAt	`string (ISO 8601)`	Required	When the conversion occurred.
count	`integer`	—	Number of conversions in this event (must be greater than zero, defaults to 1, max 1M).
origin	`string`	—	Origin or channel of the conversion, e.g. "website", "app" (max 50 characters).
externalRef	`string`	—	External reference identifier for deduplication (max 255 characters).
metadata	`object`	—	Arbitrary key-value metadata (max 50 keys, keys max 64 characters).

Response#

Returns { data } with the result.

Underlying SDK method: bw.conversions.create(params)

PATCH /v1/conversions/:id#

Update a conversion record, including its origin, external reference, metadata, and attribution details.

bash

PATCH /v1/conversions/:id
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
id	`string (UUID)`	Required	Conversion identifier to update.
sourceId	`string (UUID)`	—	Updated conversion source.
convertedAt	`string (ISO 8601)`	—	Updated conversion timestamp.
count	`integer`	—	Updated conversion count (must be greater than zero, max 1M).
origin	`string`	—	Updated origin (max 50 characters).
externalRef	`string \| null`	—	Updated external reference (max 255 characters).
metadata	`object \| null`	—	Updated metadata (max 50 keys, keys max 64 characters).

Response#

Returns { data } with the result.

Underlying SDK method: bw.conversions.update(params)

DELETE /v1/conversions/:id#

Permanently delete a conversion record.

bash

DELETE /v1/conversions/:id
Authorization: Bearer {token}

Parameters#

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

Response#

Returns { data } with the result.

Underlying SDK method: bw.conversions.delete(params)