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 already-enabled account succeeds without change. Responds with 200 OK.
Authentication: Bearer token · Role: data manager · Permission:
connectors:write · Team permission:connector_accounts.enable · Rate limit: default (120 / 60s)This now needs Data Manager, where it previously accepted Editor. Enabling an account spends a
slot against your plan's per-connector limit, and raising that limit costs money — so it is gated
the same way here as in the Hub, the Sheets add-on and Looker Studio. A key whose creator holds only
Editor will start receiving
403 FORBIDDEN on this endpoint.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 Sheets add-on, Looker 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 (e.g.
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": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}
{
"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": "Authentication required" }
}