Clients
Add client account
Link a connector account to a client.
POST /teams/{teamId}/clients/{clientId}/accounts/{connectorId}/{accountId}
Links a connector account to the client. The account ID is provider-defined and is passed straight through in the path. Returns { "added": true } on success.
Authentication: Bearer token · Role: editor · Permission:
clients:write · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The team the client belongs to.
clientId
string · uuid v7 required
The ID of the client to link the account to.
connectorId
string required
The connector the account belongs to (e.g.
gadw, fb).accountId
string required
The provider-defined account ID. This is not a UUID — it is whatever the connector uses to identify the account (for example a Google Ads customer ID or a Meta
act_… ID).A team whose plan has been cancelled cannot make changes. Write requests will fail with
402 PAYMENT_REQUIRED until the subscription is reactivated.Request
curl -X POST https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/clients/0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/accounts/gadw/1234567890 \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": { "added": true }
}
Returned when connectorId is not a recognised connector.
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Invalid connector ID: \"foo\"" }
}
{
"success": false,
"error": { "code": "PAYMENT_REQUIRED", "message": "Your team's plan has been cancelled. Please reactivate your subscription to continue." }
}
Returned when your role is below editor.
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}
Returned when the client does not exist or does not belong to this team.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Client not found" }
}
Returned when the account is already linked to the client.
{
"success": false,
"error": { "code": "CONFLICT", "message": "Account already added to this client" }
}