Mail API
API-first email service for AI agents. Provision mailboxes, send and receive messages, manage threads, search by full-text, and subscribe to events via webhooks.
API base URL:
https://inkbox.ai/api/v1/mailQuick start
Create an account and get your API key from the Inkbox console:
Get API keyAll API requests require authentication using a API key:
X-API-Key: YOUR_API_KEYMailboxes
Mailboxes are owned 1:1 by an agent identity — they're created and destroyed atomically with the identity. To provision a mailbox, create an identity; to remove one, delete the identity.
List mailboxes
GETList all mailboxes for your organization
/api/v1/mail/mailboxesGet mailbox
GETGet a single mailbox by email address
/api/v1/mail/mailboxes/{email_address}Update mailbox
PATCHUpdate webhook URL or filter mode
/api/v1/mail/mailboxes/{email_address}Messages
List messages
GETList messages in a mailbox with cursor pagination
/api/v1/mail/mailboxes/{email_address}/messagesGet message
GETGet a message with full body content
/api/v1/mail/mailboxes/{email_address}/messages/{message_id}Send message
POSTCompose and send an email
/api/v1/mail/mailboxes/{email_address}/messagesForward message
POSTForward a stored message (inline or wrapped) — creates a new thread
/api/v1/mail/mailboxes/{email_address}/messages/{message_id}/forwardUpdate message flags
PATCHUpdate is_read or is_starred on a message
/api/v1/mail/mailboxes/{email_address}/messages/{message_id}Delete message
DELETEDelete a message
/api/v1/mail/mailboxes/{email_address}/messages/{message_id}Download attachment
GETDownload a message attachment
/api/v1/mail/mailboxes/{email_address}/messages/{message_id}/attachments/{filename}Threads
List threads
GETList threads with cursor pagination, most recent activity first
/api/v1/mail/mailboxes/{email_address}/threadsGet thread
GETGet a thread with all its messages inline
/api/v1/mail/mailboxes/{email_address}/threads/{thread_id}Delete thread
DELETEDelete a thread
/api/v1/mail/mailboxes/{email_address}/threads/{thread_id}Search
Search messages (mailbox)
GETFull-text search across messages in a mailbox, ranked by relevance
/api/v1/mail/mailboxes/{email_address}/searchSearch messages (org-wide)
GETFull-text search across all mailboxes in your organization
/api/v1/mail/searchContact rules
Per-mailbox allow and block rules interpreted against the mailbox's filter_mode (blacklist by default, whitelist on demand). See the Contact rules reference and the Email guide for semantics.
List contact rules
GETList allow/block rules for a mailbox
/api/v1/mail/mailboxes/{email_address}/contact-rulesCreate contact rule
POSTAdd an allow or block rule (exact email or domain)
/api/v1/mail/mailboxes/{email_address}/contact-rulesGet contact rule
GETFetch a single rule by ID
/api/v1/mail/mailboxes/{email_address}/contact-rules/{rule_id}Update contact rule
PATCHChange action or status (admin-only)
/api/v1/mail/mailboxes/{email_address}/contact-rules/{rule_id}Delete contact rule
DELETEDelete a rule (admin-only)
/api/v1/mail/mailboxes/{email_address}/contact-rules/{rule_id}List org mail contact rules
GETOrg-wide aggregate list across every mailbox (admin-only)
/api/v1/mail/contact-rulesWebhooks
Mail event delivery is configured via the Webhook Subscriptions API — attach one or more subscriptions to the mailbox with the subset of message.* events you want. See the Webhooks guide for event types, payload format, and signature verification.
