Connections
An authorized link between a team and a data source — list connections, inspect their accounts, and remove them.
A connection is an authorized link between a team and an external data source (for example a Google Ads or Facebook Ads account). Each connection belongs to a single connector and exposes one or more accounts that the team can pull data from.
Endpoints in this resource are scoped to a team and live under /teams/{teamId}/connections. Every endpoint requires the caller to be a member of the team; the minimum role is noted on each page.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /teams/{teamId}/connections | List a team's connections |
GET | /teams/{teamId}/connections/{connectionId} | Get a single connection |
GET | /teams/{teamId}/connections/{connectionId}/accounts | List accounts under a connection |
DELETE | /teams/{teamId}/connections/{connectionId} | Delete a connection |
The connection object
{
"id": "0190f8a1-2b3c-7d4e-8f90-1a2b3c4d5e6f",
"connectorId": "gadw",
"name": "Acme Google Ads",
"status": "active",
"accountCount": 3,
"config": {},
"createdAt": "2026-01-12T08:15:00.000Z",
"updatedAt": "2026-03-04T11:42:00.000Z",
"createdBy": "0190f8a0-1a2b-7c3d-9e4f-5a6b7c8d9e0f"
}
id
string · uuid v7
The connection's unique identifier.
connectorId
string | null
The connector this connection authorizes (e.g.
gadw, ga, fads). null if the underlying connector is no longer known.name
string | null
A human-friendly label for the connection, or
null if none was set.status
string
Either
active or revoked. A revoked connection's credentials are no longer valid and must be re-authorized before it can return data.accountCount
number
The number of accounts available under this connection.
config
object
Connector-specific configuration. Internal and credential-related keys are never included.
createdAt
string
When the connection was created.
updatedAt
string | null
When the connection was last updated, or
null if it has never been updated.createdBy
string · uuid v7 | null
The ID of the user who created the connection, or
null if unknown.