Mailboxes
Create and manage mailboxes for receiving inbound email, with plan-based limits.
Mailboxes let your tenant receive inbound email at dedicated addresses. Each mailbox is scoped to a single tenant and can be used to receive and process incoming messages.
Plan limits
The number of mailboxes you can create depends on your plan:
| Plan | Max mailboxes |
|---|---|
| Trial | 1 |
| Starter | 3 |
| Growth | 10 |
| Enterprise | Unlimited |
When your account is in the expired state, no new mailboxes can be created.
Creating a mailbox
Mailboxes are created via the agentic mailbox API:
curl -X POST https://agentic-mailbox.molted.email/v1/mailboxes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tenantId": "tenant-abc",
"address": "support@example.com",
"displayName": "Support Inbox"
}'Response
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"tenantId": "tenant-abc",
"address": "support@example.com",
"displayName": "Support Inbox",
"status": "provisioning",
"config": {},
"createdAt": "2026-03-01T12:00:00Z",
"updatedAt": "2026-03-01T12:00:00Z"
}Limit exceeded
If you attempt to create a mailbox beyond your plan's limit, you'll receive a 403 Forbidden response:
{
"statusCode": 403,
"message": "Mailbox limit reached (3). Upgrade your plan to create more mailboxes."
}Mailbox status
Each mailbox has a status field:
| Status | Description |
|---|---|
provisioning | Mailbox is being set up |
active | Mailbox is ready to receive email |
paused | Mailbox is temporarily disabled |
error | Mailbox encountered a configuration error |
Listing mailboxes
curl https://agentic-mailbox.molted.email/v1/mailboxes?tenantId=tenant-abc \
-H "Authorization: Bearer YOUR_API_KEY"Checking your usage
Mailbox usage is included in the billing status endpoint:
curl https://api.molted.email/v1/billing/status \
-H "Authorization: Bearer YOUR_API_KEY"The response includes a mailboxes field:
{
"mailboxes": {
"used": 2,
"limit": 3
}
}A null limit means unlimited mailboxes (Enterprise plan).