Inboxes

An inbox is an email address your agent owns. Inboxes send and receive mail, group messages into threads, and are the unit you provision per agent, user, or task.

Create an inbox

curl -X POST https://api.sentfrom.ai/v1/inboxes \
  -H "Authorization: Bearer sf_live_…" -H "Content-Type: application/json" \
  -d '{ "local_part": "support-bot", "display_name": "Support" }'

Response

{
  "id": "b1f2…",
  "local_part": "support-bot",
  "display_name": "Support",
  "address": "support-bot@mail.sentfrom.ai"
}

Field	Required	Notes
`local_part`	yes	The part before the `@`. Lowercased automatically; `[a-z0-9._-]` only.
`display_name`	no	Friendly From name on outbound mail.
`domain_id`	no	A verified custom domain. Defaults to the shared `mail.sentfrom.ai`.

Addresses are globally unique on the shared domain. Re-using a local_part that’s already taken returns 409 address_taken.

List & delete

curl https://api.sentfrom.ai/v1/inboxes -H "Authorization: Bearer sf_live_…"
curl -X DELETE https://api.sentfrom.ai/v1/inboxes/INBOX_ID -H "Authorization: Bearer sf_live_…"

Inbox limits

Each plan includes a number of concurrent inboxes. Creating one past your limit returns 402 inbox_limit_reached with upgrade: true.

Plan	Inboxes
Free	3
Pro	100
Scale	1,500
Business	15,000

Agents typically create one inbox per user or task, so generous limits matter — see the dashboard for your current usage.

⌘I

Get started

Core concepts

Guides

Examples

Agent frameworks

DNS guides

Troubleshooting

Create an inbox

List & delete

Inbox limits

​Create an inbox

​List & delete

​Inbox limits

Create an inbox

List & delete

Inbox limits