List Connect accounts

GET/api/v2/connect/accounts

Returns the current user's connected Email, LinkedIn, and WhatsApp accounts. Call this endpoint before creating an outreach job to obtain an available account_id.

Query parameters

Example request

cURLCopy
curl "https://revor.ai/api/v2/connect/accounts?channel=linkedin&can_send=true" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Example response

JSONCopy
{
  "ok": true,
  "request_id": "req_xxx",
  "items": [
    {
      "account_id": "connect_account_xxx",
      "channel": "linkedin",
      "name": "LinkedIn Account",
      "account_identifier": "https://www.linkedin.com/in/example/",
      "status": "ok",
      "lifecycle_status": "active",
      "can_send": true,
      "can_receive": true
    }
  ]
}

status indicates whether the current connection or credentials are healthy. lifecycle_status represents the account lifecycle in Revor. Clients should not combine these internal states themselves to determine whether an account can send; always use can_send=true when selecting an account for outreach.

Typically, status=credentials means that the credentials must be updated or the account reconnected, while status=error means that the account is temporarily unavailable. Even if lifecycle_status=active, do not submit a send job when can_send=false.

Common errors