Skip to main content

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

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:
  • 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

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

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