RaabtaHQ
List team members

List team members

GET/api/v1/members

scope conversations:read

The account’s staff, for assignment. Returns ids, names and roles only — never emails. Portal-only clients are excluded.

Request
curl "https://your-crm.example.com/api/v1/members" \
  -H "Authorization: Bearer $RAABTA_API_KEY"
Response · 200 OK
{
  "data": [
    {
      "id": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f",
      "name": "Sara Ahmed",
      "role": "agent",
      "industry_role": null
    }
  ]
}

Response

Wrapped in { data: … }
NameTypeDescription
idrequired
string (uuid)User id — what `assigned_to` refers to
namerequired
string | nullDisplay name
rolerequired
string (enum)Account role — what they may administerowneradminagentviewer
industry_rolerequired
string | nullA module-contributed job title, if any

Errors

StatusCodeWhen
401unauthorizedNo usable API key: the Authorization header is missing or malformed, or the key is unknown, revoked or expired. The three are deliberately indistinguishable.
403forbiddenThe key is valid but lacks the scope this endpoint requires, or the request came from an address outside the key’s IP allowlist. The message says which.
403account_suspendedThe account this key belongs to is suspended. Rotating the key will not help; contact support.
429rate_limitedThe per-key budget, or the per-IP budget for failed authentication, is exhausted. Honour `Retry-After` before retrying.
500internalSomething failed on our side. Safe to retry with the same Idempotency-Key; quote `request_id` if it persists.