Integrations
Provider-agnostic view of the data sources feeding the marketing evidence chain: which providers are connected, which sources are selected, and which evidence kinds are covered.
Authentication required
Authorization header. See the Authentication guide for setup instructions.GET /v1/integrations
List the integration providers Brandwave offers, including ones not yet available, with the workspace’s connection state, the sources selected through each connection (site traffic, success events, search performance) and their sync status, and a coverage map of which evidence kinds currently have a live source.
GET /v1/integrations?workspace_id=1c7743a8-6410-4a9e-9f3b-2c1d5e8a4b01
Authorization: Bearer {token}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
Response
Returns { data, _meta } with the result.
POST /v1/integrations/disconnect
Disconnect an integration provider, stopping every source it supplies (for Google: the GA4 property and Search Console site) and revoking stored credentials. Historical data already synced is retained.
POST /v1/integrations/disconnect
Authorization: Bearer {token}
Content-Type: application/json
{
"workspace_id": "1c7743a8-6410-4a9e-9f3b-2c1d5e8a4b01",
"provider": "..."
}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| provider | 'google' | 'meta' | 'linkedin_ads' | 'tiktok_ads' | 'reddit_ads' | 'microsoft_ads' | 'mixpanel' | 'posthog' | 'hubspot' | 'bing' | Required | Integration provider key. |
Response
Returns { data, _meta } with the result.
POST /v1/integrations/sources/remove
Remove one selected evidence source (site traffic, success events, or search performance) so it stops syncing, without disconnecting the provider. History is retained and the source can be reselected later.
POST /v1/integrations/sources/remove
Authorization: Bearer {token}
Content-Type: application/json
{
"workspace_id": "1c7743a8-6410-4a9e-9f3b-2c1d5e8a4b01",
"kind": "..."
}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| kind | 'site_traffic' | 'success_events' | 'search_performance' | Required | Evidence a source provides: site_traffic (sessions and users), success_events (conversion events), search_performance (search impressions and clicks). |
Response
Returns { data, _meta } with the result.