sendmux-ai Inboxes API
The Inboxes API from sendmux-ai — 2 operation(s) for inboxes.
The Inboxes API from sendmux-ai — 2 operation(s) for inboxes.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sendmux-ai:sendmux-ai-inboxes-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: Programmatic access to your Sendmux email infrastructure.
title: Sendmux Inboxes API
version: 1.0.0
servers:
- description: API v1
url: https://app.sendmux.ai/api/v1
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Inboxes
paths:
/inboxes/logs:
get:
description: Returns paginated incoming message logs for billing accountability.
operationId: managementListInboxLogs
parameters:
- in: query
name: limit
required: false
schema:
description: Max results (default 25)
maximum: 100
minimum: 1
type: integer
- in: query
name: cursor
required: false
schema:
description: Cursor from previous page
type: string
- in: query
name: mailbox_id
required: false
schema:
description: Filter by mailbox public ID
type: string
- in: query
name: event_type
required: false
schema:
enum:
- message.received
- message.received.spam
type: string
- in: query
name: from_date
required: false
schema:
description: ISO 8601 start date. Date-only values start at 00:00 UTC.
type: string
- in: query
name: to_date
required: false
schema:
description: ISO 8601 end date. Date-only values include the full UTC day.
type: string
- in: query
name: search
required: false
schema:
description: Search mailbox, sender, recipient, subject, or message ID
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/IncomingLogItemCursorListResponse'
description: Incoming log list
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: Authentication required
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: Insufficient permissions
security:
- bearerAuth: []
- oauth2:
- logs.read
summary: List incoming logs
tags:
- Inboxes
/inboxes/logs/{public_id}:
get:
description: Returns one incoming message log by public ID.
operationId: managementGetInboxLog
parameters:
- in: path
name: public_id
required: true
schema:
description: Incoming log public ID (ilog_...)
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/IncomingLogItemResponse'
description: Incoming log detail
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: Authentication required
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: Insufficient permissions
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: Not found
security:
- bearerAuth: []
- oauth2:
- logs.read
summary: Get incoming log
tags:
- Inboxes
components:
schemas:
ResponseMeta:
additionalProperties: false
properties:
request_id:
example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx
type: string
required:
- request_id
type: object
IncomingLogItemResponse:
allOf:
- $ref: '#/components/schemas/SuccessEnvelope'
- properties:
data:
$ref: '#/components/schemas/IncomingLogItem'
meta:
$ref: '#/components/schemas/ResponseMeta'
required:
- data
type: object
unevaluatedProperties: false
ApiErrorDetail:
additionalProperties: false
properties:
code:
description: Machine-readable issue code from the validator (e.g. zod issue code).
example: invalid_string
type: string
field:
description: Dot-path of the offending request field.
example: recipient.email
type: string
message:
description: Human-readable issue description.
type: string
required:
- field
- code
- message
type: object
SuccessEnvelope:
properties:
meta:
additionalProperties: {}
properties: {}
type: object
ok:
enum:
- true
type: boolean
required:
- ok
- meta
type: object
IncomingLogItemCursorListResponse:
allOf:
- $ref: '#/components/schemas/SuccessEnvelope'
- properties:
data:
items:
$ref: '#/components/schemas/IncomingLogItem'
type: array
meta:
$ref: '#/components/schemas/ResponseMeta'
pagination:
$ref: '#/components/schemas/CursorPagination'
required:
- data
- pagination
type: object
unevaluatedProperties: false
CursorPagination:
additionalProperties: false
properties:
has_more:
type: boolean
next_cursor:
type: string
required:
- has_more
type: object
IncomingLogItem:
additionalProperties: false
properties:
amount:
description: Billable amount for this message in USD
type: string
billing_bucket_start:
description: ISO 8601 usage bucket start
type: string
event_type:
enum:
- message.received
- message.received.spam
type: string
from_email:
type:
- string
- 'null'
id:
description: Incoming log public ID
example: ilog_9ed2f2fdbacf38ef05c6a8b9
type: string
is_spam:
type: boolean
mailbox_email:
description: Mailbox email address
type:
- string
- 'null'
mailbox_id:
description: Mailbox public ID
type:
- string
- 'null'
message_id:
description: Message identifier when available
type:
- string
- 'null'
message_id_kind:
description: Identifier source when available
type:
- string
- 'null'
received_at:
description: ISO 8601 received timestamp
type: string
size_bytes:
type:
- number
- 'null'
subject:
type:
- string
- 'null'
to_emails:
items:
type: string
type: array
unit_amount:
description: Per-message unit amount in USD
type: string
required:
- id
- mailbox_id
- mailbox_email
- event_type
- message_id
- message_id_kind
- from_email
- to_emails
- subject
- size_bytes
- received_at
- is_spam
- billing_bucket_start
- unit_amount
- amount
type: object
ApiError:
additionalProperties: false
properties:
error:
additionalProperties: false
properties:
code:
description: Machine-readable error code
enum:
- invalid_parameter
- missing_parameter
- authentication_required
- insufficient_permissions
- not_found
- conflict
- limit_exceeded
- idempotency_conflict
- payload_too_large
- validation_error
- rate_limit_exceeded
- service_unavailable
- internal_error
example: invalid_parameter
type: string
doc_url:
description: Link to relevant documentation
type: string
errors:
description: Accumulated per-field issues for validation errors. Only present on 400/422 responses.
items:
$ref: '#/components/schemas/ApiErrorDetail'
type: array
message:
description: Human-readable error description
type: string
param:
description: The parameter that caused the error
type: string
retryable:
description: Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true.
example: false
type: boolean
required:
- code
- message
- retryable
type: object
meta:
additionalProperties: false
properties:
request_id:
example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx
type: string
required:
- request_id
type: object
ok:
enum:
- false
type: boolean
required:
- ok
- error
- meta
type: object
securitySchemes:
bearerAuth:
bearerFormat: API Key
description: Sendmux API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.
scheme: bearer
type: http
oauth2:
description: Use the authorisation-code flow with S256 PKCE and resource=https://sendmux.ai/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.
flows:
authorizationCode:
authorizationUrl: https://app.sendmux.ai/oauth/authorize
refreshUrl: https://app.sendmux.ai/oauth/token
scopes:
analytics.*: All analytics operations
analytics.read: View key usage analytics and verification logs
billing.*: All billing operations
billing.auto_topup: Configure auto top-up settings
billing.read: View balance, transactions, invoices
billing.topup: Purchase balance top-ups
calendar.read: Read calendars and events in this mailbox
calendar.write: Create calendars and create, edit and delete events in this mailbox
domain.*: All domain operations
domain.create: Add sending domains
domain.delete: Remove domains
domain.read: List/view domains and DNS status
domain.verify: Trigger domain verification
email.receive: Authorise email reception
email.send: Send email through the HTTP API
key.*: All key management operations
key.create: Create new API keys (both root and mailbox)
key.read: List/view API keys and their metadata
key.revoke: Revoke API keys
key.rotate: Rotate API keys
logs.*: All log operations
logs.read: View delivery logs
mailbox.admin.*: All mailbox admin operations
mailbox.admin.create: Create mailboxes (admin-level)
mailbox.admin.delete: Delete mailboxes (admin-level)
mailbox.admin.manage: Manage all mailbox settings
mailbox.admin.read: List/view mailboxes (admin-level)
mailbox.drafts.write: Create and edit saved mailbox drafts
mailbox.read: Read mailbox contents (folders, messages)
mailbox.settings.update: Update own mailbox settings (signature, auto-reply)
provider.*: All provider operations
provider.create: Add email provider accounts (Google, Microsoft, SMTP)
provider.delete: Remove provider accounts
provider.read: List/view provider accounts and connection status
provider.update: Update provider settings, refresh tokens
routing.*: All routing operations
routing.create: Create delivery groups
routing.delete: Remove delivery groups
routing.read: List/view delivery groups and routing rules
routing.update: Update delivery group configuration
team.*: All team operations
team.members.invite: Invite team members
team.members.remove: Remove team members
team.members.roles: Change member roles
team.read: View team settings and members
team.update: Update team settings
webhook.*: All webhook operations
webhook.create: Create webhook subscriptions
webhook.delete: Delete webhook subscriptions
webhook.manage: Rotate signing secret + send test events
webhook.read: List/view webhook subscriptions
webhook.update: Update webhook URL, event types, enabled flag
tokenUrl: https://app.sendmux.ai/oauth/token
type: oauth2