Connections

A team's authorized links to connectors. List connections, see their accounts, and delete them.

A connection is a team's authorized link to a connector, such as Google Ads or Facebook Ads. Each connection belongs to one connector and gives access to 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 needs the key holder to be a member of the team. Each page names the team permission it needs.

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

string · uuid v7

The connection's unique identifier.

connectorId

string | null

The connector this connection authorizes (for example gadw, ga or 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 needs reconnecting before it can return data. The Hub shows it as Needs reconnecting.

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.

Update team timezone

Set the IANA zone a team works in.

List connections

List all connections belonging to a team.