Connectors
Browse the connectors a team uses, their accounts, and the fields each connector exposes.
A connector is a supported data-source type — for example Google Ads, Facebook Ads, or Google Analytics 4. Under each connector a team has accounts: the individual ad, analytics, or property accounts that its connections grant access to. Enabling an account makes it available for reporting; the number of accounts you can enable per connector is governed by your team's plan.
Endpoints under /teams/{teamId}/connectors are team-scoped — they act on the team identified by the teamId path parameter, and your access depends on your role in that team.
A connector is identified by a fixed
connectorId (e.g. gadw, fads, ga4) — not a UUID. An unrecognized value returns 400 BAD_REQUEST. An accountId is a provider-defined string and is not validated as a UUID.Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /teams/{teamId}/connectors | List connectors in use by the team |
GET | /teams/{teamId}/connectors/accounts | List all connector accounts for the team |
GET | /teams/{teamId}/connectors/{connectorId}/accounts | List accounts for one connector |
GET | /teams/{teamId}/connectors/{connectorId}/fields | List a connector's dimensions and metrics |
POST | /teams/{teamId}/connectors/{connectorId}/accounts/{accountId}/enable | Enable an account |
POST | /teams/{teamId}/connectors/{connectorId}/accounts/{accountId}/disable | Disable an account |
The connector object
{
"id": "gadw",
"name": "Google Ads",
"connectionCount": 3,
"enabledAccountCount": 4
}
id
string
The connector ID — a fixed identifier such as
gadw, fads, or ga4.name
string
Human-friendly connector name (e.g.
Google Ads).connectionCount
number
How many of the team's connections are of this connector type.
enabledAccountCount
number
How many accounts of this connector are currently enabled for the team.
The connector account object
{
"id": "1234567890",
"name": "Acme — US Search",
"displayId": "123-456-7890",
"description": "Manager account",
"accessible": true,
"status": "enabled",
"connectorId": "gadw"
}
name
string
Human-friendly account name.
displayId
string
A display-formatted identifier (e.g. a hyphenated customer ID).
description
string | null
Optional descriptive label, or
null.accessible
boolean
Whether the team's connection can currently access this account.
status
string
Either
enabled or disabled.connectorId
string
The connector this account belongs to.