List Connect Accounts

GET/api/v1/connect/accounts

Returns Connect accounts available to the API key owner. Use this endpoint to obtain an account_id before creating outreach tasks.

Query Parameters

Name	Type	Required	Description
`channel`	string	No	Filters by channel. Supported values: `email`, `linkedin`, `whatsapp`.
`can_send`	boolean string	No	Filters by send capability. Supported values: `true`, `false`, `1`, `0`.

Request

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

Response

JSON
{
  "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
    }
  ]
}

Response Fields

Field	Type	Description
`account_id`	string	Connect account ID. Use this value as `account_id` in outreach endpoints.
`channel`	string	Account channel: `email`, `linkedin`, or `whatsapp`.
`name`	string	Display name for the account.
`account_identifier`	string \| null	Account identifier, such as an email address or LinkedIn profile.
`status`	string	Account status: `ok`, `credentials`, or `error`.
`lifecycle_status`	string	Connection status, such as `active`, `connected`, or `reconnect_required`.
`can_send`	boolean	Whether the account can send messages or perform actions.
`can_receive`	boolean	Whether the account can receive messages or sync status.

Status Values

`status`	Description
`ok`	The account can be used for API operations on its channel.
`credentials`	The account credentials need to be updated or reconnected.
`error`	The account is not currently available.

Errors

HTTP	Code	Description
`400`	`invalid_channel`	The `channel` value is not supported.
`400`	`invalid_can_send`	The `can_send` value is not supported.
`401`	`api_key_missing`	No API key was provided.
`401`	`api_key_invalid`	The API key is invalid.
`403`	`permission_denied`	The API key does not have access to this endpoint.
`429`	`api_rate_limit_exceeded`	The request was rate limited.