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": {
    "id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
    "name": "Priya Raman",
    "avatarUrl": null,
    "email": "[email protected]"
  },
  "updatedBy": {
    "id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
    "name": "Priya Raman",
    "avatarUrl": null,
    "email": "[email protected]"
  }
}

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

object | null

The user who created the connection, or null if unknown.

updatedBy

object | null

The user who last edited the connection, or null if it has not been edited since it was created.

Invite member

Invite a new member to a team by email.

List connections

List all connections belonging to a team.