1. Authentication & API Scopes
All Inbrix REST endpoints and MCP connections require a scoped API token (ix_live_...) passed via the standard HTTP Authorization header:
Available Token Scopes:
Send mail, draft replies, and forward messages.
Search mailboxes, read threads, fetch bodies, and download attachments.
Manage custom domains, DNS verification records, sender aliases, and team members.
Programmatically create, assign, and organize workspace action items.
Inspect and resolve Follow-up Radar items awaiting replies.
Generate executive briefs, thread summaries, and AI-assisted reply drafts.
Generate your token in Settings > API & Integrations.
2. Sending Outbound Email
Deliver mail from a verified custom domain with DKIM and SPF alignment. Use POST /api/mail when the message needs attachments or thread headers.
curl -X POST https://app.inbrix.us/api/v1/emails \
-H "Authorization: Bearer ix_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <updates@yourdomain.com>",
"to": "customer@example.com",
"subject": "Your Order #1042 is Confirmed",
"html": "<h1>Thank you</h1><p>Your package has shipped.</p>",
"text": "Thank you. Your package has shipped."
}'4. Querying & Syncing Inboxes
Search, filter, and stream inbound mail into your database or AI processing pipelines.
Query Messages
GET https://app.inbrix.us/api/mail?limit=25&category=primary&unread=trueIncremental Sync Cursor (For Polling Bots & Agents)
Pass the last cursor to fetch only new or updated messages without fetching the entire inbox repeatedly:
GET https://app.inbrix.us/api/mail/sync?cursor=0:1790620000000:425. AI Agent Integration (Model Context Protocol — 26 Tools)
Inbrix exposes a native Model Context Protocol (MCP) server with 26 built-in tools. Connect Claude Desktop, Cursor, Windsurf, or autonomous agent loops to read and send email, configure domains, verify DNS records, manage the calendar, and import an existing mailbox.
Universal Agent Configuration & Integration
Add to claude_desktop_config.json, Cursor Settings > MCP, or Windsurf mcp_config.json.
{
"mcpServers": {
"inbrix": {
"type": "http",
"url": "https://app.inbrix.us/mcp",
"headers": {
"Authorization": "Bearer ix_live_YOUR_API_KEY"
}
}
}
}All 26 Tools Available to AI Agents:
| Tool Name | Category | Purpose |
|---|---|---|
| whoami | Identity | Returns authenticated user profile, workspace account, plan limits, and sending addresses. |
| list_threads | Lists mailbox conversations newest first. Filter by view (inbox, sent, archive, etc.), category, or unread. | |
| search_mail | Searches email conversations via FTS5 across subject lines, body text, and participants. | |
| get_thread | Retrieves full thread content including messages, headers, body text, and attachments. | |
| send_message | Sends a new outbound email with custom subject, text/HTML body, and optional CC/BCC. | |
| reply | Replies directly to an existing conversation, preserving thread headers and references. | |
| update_thread | Updates flags on a conversation: mark read/unread, star, archive, trash, spam, or category. | |
| list_attachments | Lists all attachments in a thread with filenames, sizes, types, and secure download URLs. | |
| list_labels | Lists all custom workspace labels available for organizing email threads. | |
| set_thread_labels | Applies or replaces custom labels on a conversation thread. | |
| get_setup_status | Domains | Returns overview of domains, active DNS status, mailboxes, and addresses. |
| add_domain | Domains | Registers custom domain and returns exact MX, SPF, DKIM, and DMARC records. |
| get_dns_records | Domains | Returns all required DNS records (MX, SPF, DKIM, DMARC) for a custom domain. |
| verify_domain | Domains | Polls live DNS propagation across global resolvers to confirm activation. |
| create_mailbox | Domains | Creates a dedicated team mailbox (e.g., "Support", "Engineering"). |
| add_address | Domains | Configures an email alias routing into a specified mailbox. |
| list_addresses | Domains | Lists all configured email addresses and their target mailboxes. |
| list_tasks | Work | Lists workspace tasks filtered by status, priority, or due date. |
| create_task | Work | Creates a workspace task, optionally linked to an email conversation thread. |
| update_task | Work | Updates the status, priority, title, or description of a workspace task. |
| list_followups | Work | Lists emails awaiting follow-up or reply in Follow-up Radar. |
| add_sender_policy | Security | Sets an inbound sender policy (allow, block, quarantine) for an address or domain pattern. |
| list_calendar_events | Calendar | Lists workspace calendar events. |
| create_calendar_event | Calendar | Creates a calendar event on the workspace calendar. |
| start_imap_import | Mailbox | Starts an import from an external mailbox. |
| get_imap_import_status | Mailbox | Returns the status of an in-progress mailbox import. |
6. Real-Time Inbound Webhooks
Receive instant HTTPS callbacks whenever incoming email hits your verified domains. Deliveries include HMAC-SHA256 signature verification (X-Inbrix-Signature) to guarantee authenticity.
Webhook Registration
curl -X POST https://app.inbrix.us/api/webhooks \
-H "Authorization: Bearer ix_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://api.yourdomain.com/webhooks/inbrix",
"secret": "your-webhook-secret-key",
"events": ["message.inbound"]
}'7. Inbound Routing Rules & Automation
Programmatically create declarative filters to organize mailboxes, tag threads, archive newsletters, or forward critical operational alerts automatically.
Create Routing Rule
curl -X POST https://app.inbrix.us/api/routing-rules \
-H "Authorization: Bearer ix_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Auto-archive newsletters",
"match_field": "subject",
"match_operator": "contains",
"match_value": "unsubscribe",
"action": "move_folder",
"action_value": "archive"
}'