Introduction
A real email identity for your agents and applications.
Mailactor gives your application a persistent inbox that can send email, receive replies, and keep a conversation together. Your agent works with a small HTTP API; Mailactor handles email delivery and threading.
Send your first email
Go from your API key to a working inbox and a confirmed delivery.
Explore the API
Find request fields, response schemas, and required permissions.
Start with your organization
Mailactor is currently invite-only. We create your organization and supply an API key during onboarding. Once you have those, you can create and manage inboxes, send and read messages, reply to conversations, and configure webhooks through the API, within your key's permissions.
You do not need to send an organization ID with every request. Your API key identifies the organization and defines what you can access. Start by checking your access.
Four concepts to know
| Resource | What it represents | Keep this value |
|---|---|---|
| Inbox | A persistent email address belonging to your organization. | inbox.id and inbox.address |
| Thread | A conversation inside one inbox. | thread.id |
| Message | One inbound or outbound email in a thread. | message.id |
| Submission | The delivery progress of an outbound email. | submission.id |
Sending from an inbox returns both a message and a submission. The message belongs to a conversation; the submission tells you whether the email reached the recipient's mail server. An accepted API request is not yet a confirmed delivery.
Choose an address
Start with a managed address such as research-agent@inbox.mailactor.com. Mailactor handles its DNS. The starter sending allowance is shared across your organization's managed inboxes.
When you are ready, connect a domain you own, such as agents.example.com. Customer-domain inboxes use your verified domain and do not consume the managed starter allowance; normal traffic limits still apply.
Build your first conversation
- Create an inbox and save its exact address.
- Send a message to a recipient you are authorized to contact.
- Confirm delivery using the returned submission ID.
- Read incoming mail by polling or listening for a webhook.
- Reply to the message and keep the conversation in the same thread.
Current availability
The supported interface is HTTPS at https://api.mailactor.com. There is currently no human mailbox UI, IMAP, POP3, WebSocket stream, public signup, or self-service API-key rotation. Creating or rotating a key, changing organization policy, and deleting an entire organization still go through the Mailactor team.
Inbound attachment metadata is available, but the current beta blocks downloads of unscanned attachments. See attachments and inbound trust.