Jump to
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://api.inkbox.ai/api/v1/mailQuick start
Create an account and get your service token from the Inkbox console:
Get service tokenAll API requests require authentication using a service token:
X-Service-Token: YOUR_SERVICE_TOKENMailboxes
Create mailbox
POSTProvision a new mailbox with an auto-generated address
/api/v1/mail/mailboxesList 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 display name or webhook URL
/api/v1/mail/mailboxes/{email_address}Delete mailbox
DELETEDelete a mailbox
/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 via SES
/api/v1/mail/mailboxes/{email_address}/messagesUpdate 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 via presigned URL
/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/searchWebhooks
Webhooks are configured as a field on the mailbox — set webhook_url via PATCH /mailboxes/{email_address}. See the Webhooks guide for event types, payload format, and signature verification.