Connectors
List all accounts
List connector accounts across every connector the team uses.
GET /teams/{teamId}/connectors/accounts
Returns connector account objects across all of the team's connectors. Use the status query parameter to return only enabled or only disabled accounts. Results are sorted with enabled accounts first, then by name.
Authentication: Bearer token · Role: viewer · Permission:
connectors:read · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The team whose accounts to list.
Query parameters
status
string
Filter accounts by status. One of
enabled, disabled, or all. Defaults to all.status defaults to all, so omit it to retrieve every account regardless of state. Pass status=enabled to list only the accounts currently available for reporting.Request
curl "https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/connectors/accounts?status=enabled" \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
Returns an array of connector account objects.
{
"success": true,
"data": [
{
"id": "1234567890",
"name": "Acme — US Search",
"displayId": "123-456-7890",
"description": "Manager account",
"accessible": true,
"status": "enabled",
"connectorId": "gadw"
},
{
"id": "act_998877665544",
"name": "Acme — Social",
"displayId": "998877665544",
"description": null,
"accessible": true,
"status": "enabled",
"connectorId": "fads"
}
]
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "status: Invalid enum value. Expected 'enabled' | 'disabled' | 'all'" }
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Authentication required" }
}
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}