Connectors
Enable account
Enable a connector account so it is available for reporting.
POST /teams/{teamId}/connectors/{connectorId}/accounts/{accountId}/enable
Enables a single account under a connector, making it available for reporting. The operation is idempotent: enabling an account that is already enabled succeeds and changes nothing. Responds with 200 OK.
Authentication: Bearer token · Permission:
connectors:write · Team permission:connector_accounts.enable · Rate limit: default (120 / 60s)This needs a role that includes Enable accounts. Owner, Admin, Deputy Admin and Data Manager
include it. Editor and Viewer do not, although Editor was enough before. Enabling an account uses a
slot of your plan's per-connector limit, and raising that limit costs money. So the API checks the
same permission as the Hub, the Google Sheets add-on and Google Data Studio. A key whose creator has
the Editor role gets
403 INSUFFICIENT_ROLE on this endpoint. The key holder also needs a seat.The number of accounts you can enable per connector is capped by your team's plan. Once the limit is reached, enabling another account returns
402 PLAN_LIMIT_REACHED until you disable an existing account or upgrade.The plan-limit refusal changed from
403 FORBIDDEN to 402 PLAN_LIMIT_REACHED. The limit is now
enforced in the same place for every client (the Hub, the Google Sheets add-on, Google Data Studio,
this API and the MCP tools) instead of separately per client, and it answers with the same code everywhere. A
client that branches on 403 to detect a full plan must branch on 402 instead; a client that only
checks response.success is unaffected.Path parameters
teamId
string · uuid v7 required
The team that owns the connector.
connectorId
string required
The connector ID (for example
gadw). A value that is not a recognized connector returns 400 BAD_REQUEST.accountId
string required
The provider-defined account ID to enable.
Request
curl -X POST https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/connectors/gadw/accounts/1234567890/enable \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": { "enabled": true }
}
{
"success": false,
"error": {
"code": "PLAN_LIMIT_REACHED",
"message": "Your plan allows 15 accounts per connector and 15 are already enabled for Google Ads, so 1 more can't be enabled. Enable up to 0, disable some, or upgrade your plan."
}
}
{
"success": false,
"error": { "code": "INSUFFICIENT_ROLE", "message": "[email protected] is not allowed to use connector_accounts.enable. This needs a role that includes it; their role is editor." }
}
{
"success": false,
"error": {
"code": "PAYMENT_REQUIRED",
"message": "Your team's plan has been cancelled. Please reactivate your subscription to continue."
}
}
{
"success": false,
"error": {
"code": "ACCOUNT_NOT_FOUND",
"message": "No accounts were found for this connection. Please check the connection and try again."
}
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Invalid or expired session" }
}