> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connected Accounts

> List the accounts your workspace can send from: mailboxes, WhatsApp and LinkedIn accounts, and phone numbers.

## Overview

A **connected account** is an account Sendora can send from:

| Channel | What it is | Sends |
| - | - | - |
| `email` | A mailbox that is ready to send | Emails, threaded replies |
| `whatsapp` | A connected WhatsApp account | Text messages, media, templates |
| `linkedin` | A connected LinkedIn account | Messages, connection requests, voice notes |
| `phone` | A phone number | SMS, MMS, AI calls |

Each account's `id` is the `account_id` you pass when you choose which accounts a voice agent may send from (Save channel assignments). A phone account's `id` is the same id List connected phone numbers returns.

## List connected accounts

```bash theme={"dark"}
curl https://api.sendora.ai/api/v1/public/connected-accounts \
  -H "X-API-Key: sk_live_..."
```

```json theme={"dark"}
{
  "accounts": [
    {
      "id": "Xk3p9LmQ2vRt7YbN4cHs8A",
      "provider": "EMAIL",
      "channel": "email",
      "channel_label": "Email",
      "identifier": "sarah@yourcompany.com",
      "display_name": "Sarah Lee",
      "status": "active"
    },
    {
      "id": "b7Tq2WnE5uJx8KdR1mYs4Q",
      "provider": "PHONE",
      "channel": "phone",
      "channel_label": "Phone (SMS / Voice)",
      "identifier": "+14155551234",
      "display_name": "+14155551234",
      "status": "active",
      "created_at": "2026-05-01T10:00:00Z"
    }
  ],
  "total": 2
}
```

## Filter by channel

```bash theme={"dark"}
# Only phone numbers
curl "https://api.sendora.ai/api/v1/public/connected-accounts?channel=phone" \
  -H "X-API-Key: sk_live_..."

# Only active accounts
curl "https://api.sendora.ai/api/v1/public/connected-accounts?status=active" \
  -H "X-API-Key: sk_live_..."
```

`channel` is one of `email`, `whatsapp`, `linkedin` or `phone`.

## Choose which accounts an agent sends from

Pass account ids to Save channel assignments. The channel in the address must match the channel of every account you send:

```bash theme={"dark"}
curl -X POST "https://api.sendora.ai/api/v1/public/voice-agents/AGENT_ID/channels/email" \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "assignments": [
      { "account_id": "Xk3p9LmQ2vRt7YbN4cHs8A", "daily_limit": 50 }
    ]
  }'
```

An account that is not connected in your workspace is rejected with `422` and nothing is saved.

## Sending a single message

`POST /conversations/{lead_id}/messages` chooses the sending account for you: the account the lead's existing conversation runs on, and otherwise one picked by Sendora's sender rotation. There is no field to pick the account for a single message.

## Use in voice calls

To choose the caller number for a single call, pass the phone account's `identifier` as `from_number`:

```bash theme={"dark"}
curl -X POST https://api.sendora.ai/api/v1/public/voice/calls \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "LEAD_ID",
    "agent_id": "AGENT_ID",
    "from_number": "+14155551234"
  }'
```

## Connect new accounts

New accounts are connected in the Sendora dashboard under **Settings**. Once connected and ready, they appear here.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.