> ## 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.

# Sending Accounts and Domains

> See and tune the mailboxes, WhatsApp and LinkedIn accounts you send from, and read your email domains.

## Overview

A **sending account** is anything a workspace sends from: a mailbox, a WhatsApp or LinkedIn account, or your own SMS account. Phone numbers have their own endpoints under [Phone numbers](https://docs.sendora.ai/api-reference/introduction.md). An **email domain** is the domain your mailboxes live on.

The API lets you read both and change the settings that do not involve buying or reconnecting anything. Connecting an account with a sign in, buying mailboxes or domains, and anything that changes DNS stay in the app for now.

## List your accounts

```bash theme={"dark"}
curl "https://api.sendora.ai/api/v1/public/connections?type=account&channel=email" \
  -H "X-API-Key: sk_live_..."
```

`channel` is `email`, `whatsapp`, `linkedin` or `sms`. `status` filters by status, for example `active`. The response lists each account's `id`, `channel`, `provider`, `address`, `status`, `lifecycle_status` and warmup fields.

The `id` is the same value you pass as `account_id` when you save a voice agent's channel assignments.

## Read one account in detail

Pass `id`, and `include` with any of `profile`, `health`, `limits`, `strength`, `incidents` and `preferences`:

```bash theme={"dark"}
curl "https://api.sendora.ai/api/v1/public/connections?type=account&id=ACCOUNT_ID&include=health,limits" \
  -H "X-API-Key: sk_live_..."
```

* `health` says whether the account is healthy and whether it can send right now.
* `limits` lists the daily limit for each action, how much is used today, and the safe ceiling.
* `strength` shows how far along warmup is.
* `incidents` lists recent safety pauses with a plain explanation.

## Change an account

```bash theme={"dark"}
curl -X PATCH "https://api.sendora.ai/api/v1/public/connections/ACCOUNT_ID" \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "account",
    "from_name": "Onit at Sendora",
    "signature": "Onit\nSendora",
    "preferences": { "quiet_hours_start": 9, "quiet_hours_end": 18, "weekend_mode_enabled": true },
    "limits": { "email_send": 40 }
  }'
```

`quiet_hours_start` and `quiet_hours_end` are the hours of the day, in the account's `account_timezone`, that it sends in (for example 9 and 18; the end can be 1 to 24). Send only what should change. The steps run in this order: profile, active hours, limits. If a step is refused, the ones before it stay applied and the error says which field was wrong. Use the action names from `include=limits` as the keys of `limits`. A limit above the safe ceiling is brought down to it.

Mark the reconnect prompt as seen with `POST /connections/ACCOUNT_ID/actions` and `{ "type": "account", "action": "ack_reconnect" }`.

## Email domains

```bash theme={"dark"}
curl "https://api.sendora.ai/api/v1/public/connections?type=domain" -H "X-API-Key: sk_live_..."

curl "https://api.sendora.ai/api/v1/public/connections?type=domain&id=DOMAIN_ID&include=dns" -H "X-API-Key: sk_live_..."
```

Each domain shows its `status`, `dns_health`, whether `dns_needs_repair`, and any forwarding or catch-all address. `include=dns` adds the live DNS records, read from the domain provider when you ask, so it can take a moment.

## Assistants and the MCP

The Sendora MCP exposes the same reads and changes as `read_channels` (actions `accounts` and `domains`) and `edit_channels` (actions `update_account` and `account_step`).

## Errors

| Status | Meaning |
| - | - |
| `404` | No account or domain with that `id` in this workspace. |
| `422` | An unknown `include` value, a setting outside its range, or an account type that does not have that setting. |
| `503` | The domain provider could not be reached for `include=dns`. Try again shortly. |


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