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

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

GET /v1/integrations#

List every integration provider Brandwave offers (Google Analytics and Search Console today; Mixpanel, PostHog, HubSpot, Bing, Clarity coming) with the organization’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.

bash

GET /v1/integrations?organization_id=1c7743a8-6410-4a9e-9f3b-2c1d5e8a4b01
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization 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.

Owner only

bash

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

{
  "organization_id": "1c7743a8-6410-4a9e-9f3b-2c1d5e8a4b01",
  "provider": "..."
}

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
provider	`'google' \| '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.

Owner only

bash

POST /v1/integrations/sources/remove
Authorization: Bearer {token}
Content-Type: application/json

{
  "organization_id": "1c7743a8-6410-4a9e-9f3b-2c1d5e8a4b01",
  "kind": "..."
}

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization 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.