Google oauth#

Google OAuth integration for connecting Google Analytics.

Authentication required

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

POST /v1/google-oauth/auth-url#

Generate a Google OAuth authorization URL for connecting Google Analytics.

Owner only
bash
POST /v1/google-oauth/auth-url
Authorization: Bearer {token}
Content-Type: application/json

{
  "organization_id": "org_123"
}

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
redirectPathstringPath to redirect to after OAuth (max 500 characters).

Response#

Returns { data } with the result.

Underlying SDK method: bw.google.connect(params)

POST /v1/google-oauth/select-property#

Select a Google Analytics property for the organization.

Owner only
bash
POST /v1/google-oauth/select-property
Authorization: Bearer {token}
Content-Type: application/json

{
  "organization_id": "org_123",
  "property_id": "..."
}

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
propertyIdstringRequiredGA4 property identifier to connect (max 64 characters).

Response#

Returns { data } with the result.

Underlying SDK method: bw.google.selectProperty(params)

POST /v1/google-oauth/disconnect#

Disconnect Google OAuth and remove stored tokens.

Owner only
bash
POST /v1/google-oauth/disconnect
Authorization: Bearer {token}
Content-Type: application/json

{
  "organization_id": "org_123"
}

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.

Response#

Returns { data } with the result.

Underlying SDK method: bw.google.disconnect(params)