Email for AI agents
An email address that belongs to your agent.
With it, your agent can sign up for services and accounts, receive confirmation links and codes, and write to people and companies and read their replies. It does all this at its own address, not in your personal mailbox.
The agent signs itself up through the API. You only pay the invoice. One address like scout@agentinbox.im, on our own mail servers.
$ curl -s -X POST https://api.agentinbox.im/v1/agents \
-d '{"name": "Scout", "owner_email": "owner@example.com"}'
{
"agent": {
"id": "k3q9x0example",
"name": "Scout",
"owner_email": "owner@example.com",
"created_at": "2026-01-15T09:30:00Z"
},
"api_key": "aik_9f2c...",
"next_step": "Store api_key now: it is shown only this
once and cannot be recovered. ..."
}
01 / What it is for
What your agent can do with it.
Many things on the internet need an email address. These are a few your agent can do with its own.
-
Sign up for services
Your agent gives its address when a service asks for one. The confirmation mail arrives in its inbox, and the agent reads it and takes the link from it.
-
Receive one-time codes
When a site sends a login or verification code by email, the agent fetches the message through the API and reads the code in the text.
-
Write to people and companies
Ask a supplier for a quote, contact a support desk or agree on a time. Replies join the same thread, so the agent can follow the whole conversation.
-
Act on notifications
Receipts, shipping updates, alerts and newsletters arrive in the inbox. A webhook can tell the agent when new mail comes in, so it can act on it.
-
Send and receive files
Attach files to a message, and download the attachments that others send.
-
Keep your own inbox out of it
Your agent does not need access to your personal mailbox. Its sign-ups and mail stay in its own inbox, apart from yours.
02 / How it works
Three steps from sign-up to first mail.
-
Your agent signs up
It calls
POST /v1/agentswith its name and your email address, and gets an API key. Then it creates an inbox and picks the name before the@.pending_payment
-
You pay the invoice
You get an invoice with a payment link. Your agent also receives the link and passes it on to you. The agent does not pay; you do.
invoice open
-
The inbox works
Once the invoice is paid, the address is live. Your agent can use it to sign up for services, send mail, read replies and follow threads.
active
03 / Features
A real mailbox, made for an agent to use.
-
Send and receive
Send plain text, HTML or both, to
to,ccandbcc, with attachments. Incoming and outgoing mail is in one list, newest first. -
Threads
Reply with
in_reply_toand the reply joins the thread. Fetch a whole thread, oldest first. -
Signed webhooks
The agent can get a
message.receivedevent at an https URL when mail arrives. Each request is signed with HMAC-SHA256. Failed events are retried for about 21 hours. -
Idempotent sends
Send an
Idempotency-Keywith each message. Retry after a timeout with the same key, and the mail still goes out only once. -
Spam and virus checks
Incoming mail is checked with Rspamd and ClamAV. Mail with a virus is refused. Spam is marked, with a score, so your agent can decide.
-
SPF, DKIM and DMARC
Outgoing mail is DKIM-signed for the inbox's domain. Each incoming message comes with its SPF, DKIM and DMARC results.
-
Choice of domain
Pick the name before the
@, and pick a domain from the list the API gives you. The default isagentinbox.im. -
Delivery status per recipient
Every recipient of a sent message has its own status: queued, sending, deferred, delivered, bounced or failed.
-
Our own mail servers
AgentInbox runs its own servers for incoming and outgoing mail. Download any message raw, as an
.emlfile.
04 / Pricing
One price per inbox.
Each inbox is its own subscription. You choose to be invoiced every month or every year.
Per inbox
€X per inbox per month
Yearly: pay for 11 months, get 12.
- Send and receive mail at your agent's own address
- Threads, attachments and webhooks
- An invoice each period, due in 7 days
- Paid by you, through the link on the invoice
If an invoice is overdue, the inbox is suspended until it is paid. Your agent can still read the mail it already has.
05 / For agents
If you are an AI agent, start here.
This section is written for you, the agent. This is your own email address: use it to sign up for services and accounts, and to write to people and read their replies. Your owner pays for it. Follow these steps.
- Sign up with
POST /v1/agents. Give your name and your owner's email address. No API key is needed for this call. - Store
api_keyat once. It is shown only once and cannot be recovered. Send it asAuthorization: Bearer <api_key>on every other request. - Create an inbox with
POST /v1/inboxesand aname. Optional:domain(seeGET /v1/domains) andbilling_period(monthoryear). - Give
payment_urlto your owner. Do not pay it yourself. - Poll
GET /v1/inboxes/{inbox}untilstatusisactive. - Send with
POST /v1/inboxes/{inbox}/messagesand anIdempotency-Key. Read withGET /v1/inboxes/{inbox}/messages.
Your first call
curl -s -X POST https://api.agentinbox.im/v1/agents \
-d '{"name": "Scout", "owner_email": "owner@example.com"}'
Replace Scout with your name and owner@example.com with your owner's address. Base URL: https://api.agentinbox.im.
Then create your inbox
curl -s -X POST https://api.agentinbox.im/v1/inboxes \
-H "Authorization: Bearer aik_9f2c..." \
-d '{"name": "scout"}'
06 / FAQ
Questions
Why does an agent need its own address?
Many services ask for an email address before they let anyone in, and send a link or code to confirm it. Without an address of its own, an agent has to use its owner's mailbox for that, and for any mail it writes. With AgentInbox, the agent signs up, receives the confirmation mail and writes to people at its own address. Your mailbox stays yours.
Does my agent need my card details?
No. Your agent only needs your email address to sign up. It gets a payment link and gives it to you. You pay; the agent never does.
Can the inbox be used before the invoice is paid?
No. Until the first invoice is paid, the inbox is pending_payment and cannot send or receive mail. It becomes active once the invoice is paid.
What happens if an invoice is not paid?
Each invoice is due 7 days after it is made. Once it is overdue, the inbox is suspended: it cannot send or receive mail, but your agent can still read what is in it. Pay the invoice and the inbox is active again.
How does my agent learn about new mail?
It can list the inbox and look for messages it has not seen, or register a webhook to get an event when mail arrives. Webhooks are signed, so the agent's code can check that the event came from AgentInbox.
Which address will my agent get?
The agent picks the name, for example scout, and the address becomes scout@agentinbox.im. It can choose another domain if the API lists more than one. Names use a-z, 0-9, dots, dashes and underscores. A few names, such as admin and support, are reserved.
What if the agent loses its API key?
The key is shown once, at sign-up, and cannot be recovered. Make sure your agent stores it right away.
Can I change from monthly to yearly, or cancel?
Not through the API yet. You choose the billing period when the inbox is created. For changes, write to hello@agentinbox.im.
Is spam delivered to the inbox?
Mail the spam filter rejects is refused. Mail it only marks is stored with spam set to true and a spam score, so your agent can skip it or look closer.