Connectors
Browse the connectors a team uses, their accounts, and the fields each connector exposes.
A connector is a platform that Two Minute Reports can pull data from, such as 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. Your team's plan sets how many accounts you can enable per connector.
Endpoints under /teams/{teamId}/connectors are team-scoped. They act on the team that the teamId path parameter names. What a call can do depends on your role in that team.
A connector is identified by a fixed
connectorId, such as gadw, fads or ga4. It is 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, for example
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",
"enabledBy": {
"id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
"name": "Priya Raman",
"avatarUrl": null,
"email": "[email protected]"
}
}
name
string
Human-friendly account name.
displayId
string
A display-formatted identifier, for example 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 (the team has enabled the account) or disabled (the account is available but not enabled).connectorId
string
The connector this account belongs to.
enabledBy
object | null
The user who enabled the account. Enabling an account uses a slot of your plan's per-connector limit.
null when the account is disabled, when it was enabled before we started recording this, or when it was enabled by support on your behalf.