# Qubrics > The intelligent email layer - [Welcome to Qubrics](https://sendmux.ai/docs/index.md): Learn what Qubrics does, where to start, and which guides or API references to use next. - [Quickstart](https://sendmux.ai/docs/getting-started/quickstart.md): Create a team, add a mailbox, send a test email, and watch the result in Qubrics. - [Existing integrations](https://sendmux.ai/docs/getting-started/existing-integrations.md): Keep your existing service addresses, credentials and published developer tools working with Qubrics. - [SDKs](https://sendmux.ai/docs/developer-tools/sdks/index.md): Choose a Qubrics SDK package and the API surface it should use. - [TypeScript SDK](https://sendmux.ai/docs/developer-tools/sdks/typescript.md): Install and configure the Qubrics TypeScript SDK packages. - [Python SDK](https://sendmux.ai/docs/developer-tools/sdks/python.md): Install and configure the Qubrics Python SDK packages. - [Go SDK](https://sendmux.ai/docs/developer-tools/sdks/go.md): Install and configure the Qubrics Go module. - [PHP SDK](https://sendmux.ai/docs/developer-tools/sdks/php.md): Install and configure the Qubrics PHP SDK packages. - [Ruby SDK](https://sendmux.ai/docs/developer-tools/sdks/ruby.md): Install and configure the Qubrics Ruby SDK gems. - [Rust SDK](https://sendmux.ai/docs/developer-tools/sdks/rust.md): Install and configure the Qubrics Rust SDK crate. - [Versioning and support](https://sendmux.ai/docs/developer-tools/sdks/versioning-support.md): Understand Qubrics SDK package releases, compatibility, and support expectations. - [CLI](https://sendmux.ai/docs/developer-tools/cli.md): Install and configure the Qubrics CLI for management, mailbox, and sending workflows. - [Postman collections](https://sendmux.ai/docs/developer-tools/postman.md): Import Qubrics API collections into Postman and configure your API key. - [Connect an integration and manage its inboxes](https://sendmux.ai/docs/developer-tools/integration-connections.md): Validate a Qubrics connection, select an authorised inbox and manage its lifecycle. - [Read mailbox costs for integrations](https://sendmux.ai/docs/developer-tools/mailbox-costs.md): Reconcile the posted cost of one mailbox across incoming email, outgoing email and storage. - [OAuth for REST APIs](https://sendmux.ai/docs/developer-tools/oauth.md): Configure scoped OAuth access to the Sending, Mailbox, and Management APIs. - [Mailbox targeting and capabilities](https://sendmux.ai/docs/developer-tools/mailbox-api/targeting-and-capabilities.md): Select a granted mailbox and discover supported Mailbox API capabilities and limits. - [Mailbox operations and usage](https://sendmux.ai/docs/developer-tools/mailbox-api/operations-and-usage.md): Work with sender identities, send submissions, quotas, and mailbox usage. - [Manage mailbox calendars and events](https://sendmux.ai/docs/developer-tools/mailbox-api/calendars.md): Create private calendars, save non-sending events, apply conditional changes, and synchronise event state. - [Mailbox threads](https://sendmux.ai/docs/developer-tools/mailbox-api/threads.md): List and read Mailbox API conversation threads and their messages. - [Save, edit and send mailbox drafts](https://sendmux.ai/docs/developer-tools/mailbox-api/saved-drafts.md): Prepare threaded replies, review saved revisions and send or schedule the approved draft. - [Search and batch mailbox messages](https://sendmux.ai/docs/developer-tools/mailbox-api/search-and-batch.md): Filter, count, search, retrieve, update, and delete mailbox messages in batches. - [Read mailbox message content](https://sendmux.ai/docs/developer-tools/mailbox-api/message-content.md): Read raw or cleaned mailbox message bodies with content controls. - [Mailbox API attachments](https://sendmux.ai/docs/developer-tools/mailbox-api/attachments.md): Upload outbound mailbox attachments and download attachments from received messages. - [Synchronise mailbox data](https://sendmux.ai/docs/developer-tools/mailbox-api/sync.md): Synchronise mailbox resources with state tokens, change endpoints, and realtime events. - [Agent access](https://sendmux.ai/docs/ai-integrations/agent-access.md): Register a durable agent inbox, invite its human owner, and unlock delegated sending after approval. - [Agent skills](https://sendmux.ai/docs/ai-integrations/agent-skills.md): Install Qubrics Agent Skills so AI coding tools choose the right Qubrics API, CLI, MCP, or SDK workflow. - [A2A](https://sendmux.ai/docs/ai-integrations/a2a.md): Discover and connect A2A-compatible agents to Qubrics with OAuth. - [MCP](https://sendmux.ai/docs/ai-integrations/mcp/index.md): Connect AI tools to Qubrics documentation and product tools. - [MCP client setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/index.md): Configure Qubrics MCP in documented AI clients. - [Claude and Claude Desktop MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/claude.md): Configure Qubrics MCP in Claude and Claude Desktop. - [Claude Code MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/claude-code.md): Configure Qubrics MCP in Claude Code. - [Cursor MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/cursor.md): Configure Qubrics MCP in Cursor. - [Codex MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/codex.md): Configure Qubrics MCP in Codex. - [ChatGPT MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/chatgpt.md): Configure Qubrics MCP in ChatGPT. - [Connect Atlassian to Qubrics MCP](https://sendmux.ai/docs/ai-integrations/mcp/clients/atlassian.md): Add hosted Qubrics MCP as a custom external server in Atlassian administration. - [Hoot MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/hoot.md): Configure Qubrics MCP in Hoot. - [Gemini CLI MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/gemini-cli.md): Configure Qubrics MCP in Gemini CLI. - [Qwen Code MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/qwen-code.md): Configure Qubrics MCP in Qwen Code. - [Kiro MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/kiro.md): Configure Qubrics MCP in Kiro. - [OpenCode MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/opencode.md): Configure Qubrics MCP in OpenCode. - [Zed MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/zed.md): Configure Qubrics MCP in Zed. - [Visual Studio MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/visual-studio.md): Configure Qubrics MCP in Visual Studio. - [VS Code MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/vs-code.md): Configure Qubrics MCP in VS Code. - [Windsurf and Cascade MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/windsurf-cascade.md): Configure Qubrics MCP in Windsurf and Cascade. - [Cline MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/cline.md): Configure Qubrics MCP in Cline. - [Roo Code MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/roo-code.md): Configure Qubrics MCP in Roo Code. - [Warp local app MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/warp.md): Configure Qubrics MCP in Warp local app. - [JetBrains AI Assistant MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/jetbrains-ai-assistant.md): Configure Qubrics MCP in JetBrains AI Assistant. - [Continue MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/continue.md): Configure Qubrics MCP in Continue. - [LM Studio MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/lm-studio.md): Configure Qubrics MCP in LM Studio. - [GitHub Copilot CLI MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/github-copilot-cli.md): Configure Qubrics MCP in GitHub Copilot CLI. - [GitHub Copilot coding agent MCP setup](https://sendmux.ai/docs/ai-integrations/mcp/clients/github-copilot-coding-agent.md): Configure Qubrics MCP in GitHub Copilot coding agent. - [Agent frameworks](https://sendmux.ai/docs/ai-integrations/frameworks/index.md): Give an agent built on any major framework its own mailbox and sending access. - [Mastra](https://sendmux.ai/docs/ai-integrations/frameworks/mastra.md): Give a Mastra agent a Qubrics mailbox and sending access through MCP. - [LangGraph](https://sendmux.ai/docs/ai-integrations/frameworks/langgraph.md): Load Qubrics mailbox and sending tools into a LangGraph agent through the LangChain MCP adapters. - [CrewAI](https://sendmux.ai/docs/ai-integrations/frameworks/crewai.md): Attach Qubrics mailbox and sending tools to a CrewAI agent or crew. - [AI SDK](https://sendmux.ai/docs/ai-integrations/frameworks/ai-sdk.md): Use Qubrics mailbox and sending tools from the AI SDK with generateText or streamText. - [OpenAI Agents SDK](https://sendmux.ai/docs/ai-integrations/frameworks/openai-agents-sdk.md): Give an OpenAI Agents SDK agent a Qubrics mailbox through an MCP server. - [Google ADK](https://sendmux.ai/docs/ai-integrations/frameworks/google-adk.md): Add Qubrics mailbox and sending tools to a Google ADK agent with an MCP toolset. - [Sending by HTTP](https://sendmux.ai/docs/sending/http.md): Send single or batch email requests through the Qubrics Sending API. - [Sending via SMTP](https://sendmux.ai/docs/sending/smtp.md): Connect an SMTP-compatible app or mail client to Qubrics. - [Template variables](https://sendmux.ai/docs/sending/template-variables.md): Insert values from the selected sending account into sender display names, email subjects and bodies. - [Attachments](https://sendmux.ai/docs/sending/attachments.md): Send, upload, and download attachments with Qubrics. - [Idempotency](https://sendmux.ai/docs/sending/idempotency.md): Use the Idempotency-Key header to make mutating requests safe to retry. - [Sending accounts](https://sendmux.ai/docs/sending/accounts/index.md): Add, import, route, and monitor the accounts Qubrics uses to deliver email. - [Google and Microsoft setup](https://sendmux.ai/docs/sending/accounts/google-microsoft.md): Prepare your organisation, import accounts, and authorise Google Workspace or Microsoft 365 mailboxes for sending. - [Delivery groups](https://sendmux.ai/docs/sending/accounts/delivery-groups.md): Group sending providers, scope credentials, and restrict individual messages to authorised groups. - [HTTP provider](https://sendmux.ai/docs/sending/accounts/http-provider.md): What the coming-soon HTTP provider option means in Accounts. - [Mailboxes](https://sendmux.ai/docs/mailboxes/index.md): Create mailboxes, manage passwords, set sender identity, and control inbound sender rules. - [Manage Inbox conversations](https://sendmux.ai/docs/mailboxes/inbox.md): Search, select, and update conversations across one mailbox or a unified Inbox view. - [Mailbox push delivery](https://sendmux.ai/docs/mailboxes/push-delivery.md): Understand the coming-soon push URL option shown when creating a mailbox. - [Domains](https://sendmux.ai/docs/domains/index.md): Add, verify, and manage custom domains for sending and receiving. - [Domain settings](https://sendmux.ai/docs/domains/settings.md): Understand domain-level inbound settings for sending and receiving domains. - [Dashboard and logs](https://sendmux.ai/docs/monitoring/dashboard-logs.md): Monitor sending activity, filter delivery logs, and export log data. - [Deliverability](https://sendmux.ai/docs/monitoring/deliverability.md): Use deliverability views to monitor bounce rates, complaint rates, and provider health. - [Webhooks setup](https://sendmux.ai/docs/webhooks/setup.md): Subscribe to Qubrics events, verify signatures, and review delivery attempts. - [Verify webhook signatures](https://sendmux.ai/docs/webhooks/verify-signatures.md): Verify the HMAC-SHA256 signature on every Qubrics webhook delivery. - [Webhook replay](https://sendmux.ai/docs/webhooks/replay.md): Understand the coming-soon replay action on webhook delivery attempts. - [Cold email outreach and GTM from your own inboxes](https://sendmux.ai/docs/use-cases/cold-email-outreach.md): Qubrics is an email layer that routes cold outreach through inboxes you own. Add sending accounts, set per-account caps, and run your GTM motion from an AI tool. - [Use Qubrics with MailWizz for cold email outreach](https://sendmux.ai/docs/integrations/email-marketing/mailwizz.md): Connect MailWizz to Qubrics, set humanised sending limits, and run cold email outreach campaigns with scheduled follow-ups and signed feedback. - [Teams and access](https://sendmux.ai/docs/account/teams-and-access.md): Create teams, invite members, assign roles, and schedule team deletion. - [Account settings](https://sendmux.ai/docs/account/account-settings.md): Update your profile, review active sessions, change your password, and manage passkeys. - [API keys](https://sendmux.ai/docs/account/api-keys.md): Create, scope, rotate, and revoke Qubrics API keys. - [Billing](https://sendmux.ai/docs/account/billing.md): Understand per-event usage charges, manage team balance, and review transactions. - [Team limits](https://sendmux.ai/docs/account/team-limits.md): Review Free hard limits, Pro capacity, and managed sending safeguards. - [Introduction](https://sendmux.ai/docs/api/introduction.md): Programmatic access to your Qubrics email infrastructure. - [Errors](https://sendmux.ai/docs/api/errors.md): Error codes and handling for the Qubrics API. - [Get Management connection](https://sendmux.ai/docs/api/connection/get-management-connection.md): Validate this credential and return its team, connection label, permissions and authorised mailboxes. No additional read permission or mailbox selection is required. Mailbox storage and sending availability are not checked. No user profile or secrets are returned. - [List mailbox domains](https://sendmux.ai/docs/api/domains/list-mailbox-domains.md): Returns a cursor-paginated list of sending domains configured for the team, ordered by `created_at` descending. Each entry includes the DNS records the customer must place, the current verification status, and the SES DKIM state. Pass `cursor=` from the previous response to fetch the ne… - [Add a mailbox domain](https://sendmux.ai/docs/api/domains/add-a-mailbox-domain.md): Creates a new domain and returns the DNS records the customer must place before verification can succeed. `send_only` configures outbound sending without changing MX records. `send_receive` also configures the domain for hosted mailboxes. Provisioning touches our email platform and Amazon SES; on an… - [Get a mailbox domain](https://sendmux.ai/docs/api/domains/get-a-mailbox-domain.md): Returns a single domain including its DNS records and latest verification state. Responses carry a weak `ETag` header — send it back as `If-None-Match` on the next request and the server will return `304 Not Modified` (no body) when the resource has not changed. - [Update a mailbox domain](https://sendmux.ai/docs/api/domains/update-a-mailbox-domain.md): Upgrades a send-only domain to sending and receiving. Downgrades are rejected. After upgrade, the domain returns to `pending` until the required MX record verifies. - [Download a domain as a zone file](https://sendmux.ai/docs/api/domains/download-a-domain-as-a-zone-file.md): Returns the domain's DNS records formatted as a BIND-style zone file fragment. Suitable for direct paste into a DNS provider that accepts zone-file imports. - [Verify a mailbox domain](https://sendmux.ai/docs/api/domains/verify-a-mailbox-domain.md): Checks the domain's published DNS records and latest Amazon SES DKIM and MAIL FROM statuses. If every required check passes, the domain is marked verified. A previously failed domain remains failed until a complete check succeeds. Domains automatically re-verify every 6 hours — this endpoint is only… - [Delete a mailbox domain](https://sendmux.ai/docs/api/domains/delete-a-mailbox-domain.md): Removes a domain from our mail platform, Amazon SES, and Qubrics. Blocked if any active mailbox still uses the domain — delete those mailboxes first. - [Get domain-wide sender filters](https://sendmux.ai/docs/api/domain-filters/get-domain-wide-sender-filters.md): Returns the current sender-filter mode and rule set applied to every mailbox under this domain. Only sending and receiving domains support domain-wide filters. Per-mailbox rules take precedence at match time. - [Replace domain-wide sender filters](https://sendmux.ai/docs/api/domain-filters/replace-domain-wide-sender-filters.md): Atomically replaces the sender-filter mode and rule set for an entire sending and receiving domain. Applies to every mailbox under the domain unless that mailbox has its own per-mailbox rules (which take precedence). Maximum 1000 rules per request. - [List mailboxes](https://sendmux.ai/docs/api/mailboxes/list-mailboxes.md): Returns a cursor-paginated list of mailboxes configured for the team, ordered by `created_at` descending. Pass `cursor=` from the previous response to fetch the next page. - [Create a mailbox](https://sendmux.ai/docs/api/mailboxes/create-a-mailbox.md): Provisions a new mailbox plus an initial bearer token and matching IMAP/SMTP mailbox password. The domain portion of the email must already be verified via POST /domains. If supplied, `quota_bytes` must be one of the current storage tiers: 1073741824 (1 GB), 5368709120 (5 GB), or 53687091200 (50 GB)… - [Get a mailbox](https://sendmux.ai/docs/api/mailboxes/get-a-mailbox.md): Returns a single mailbox, tenant-scoped to the caller's team. Responses carry a weak `ETag` header — send it back as `If-None-Match` on the next request and the server will return `304 Not Modified` (no body) when the resource has not changed. The same ETag is the value to use in `If-Match` on PATCH… - [Read mailbox costs](https://sendmux.ai/docs/api/mailboxes/read-mailbox-costs.md): Read cumulative mailbox costs for a half-open window: start is included and end is excluded. Requires mailbox.admin.read and team-wide mailbox access. Retained usage remains readable after mailbox deletion while the team and credential remain active. Quantities and USD amounts are decimal strings. p… - [Update a mailbox](https://sendmux.ai/docs/api/mailboxes/update-a-mailbox.md): Updates any combination of display_name, quota_bytes, and send_scope on a mailbox. The display_name and send_scope changes land in a single transaction; quota_bytes is applied afterwards because it also updates external state on our mail platform. Quota can only be set to 1073741824 (1 GB), 53687091… - [Delete a mailbox](https://sendmux.ai/docs/api/mailboxes/delete-a-mailbox.md): Removes a mailbox from our mail platform, Amazon SES (for `@myagent.mx` addresses), and Qubrics. All associated API keys are revoked. - [Suspend a mailbox](https://sendmux.ai/docs/api/mailboxes/suspend-a-mailbox.md): Suspends a mailbox without deleting messages, credentials, or settings. Suspended mailboxes cannot receive mail, authenticate to mailbox protocols, or send from the mailbox address. The operation is idempotent and accepts `Idempotency-Key` for safe retries. - [Resume a mailbox](https://sendmux.ai/docs/api/mailboxes/resume-a-mailbox.md): Restores a suspended mailbox so it can authenticate, receive mail, and send from the mailbox address again. The operation is idempotent and accepts `Idempotency-Key` for safe retries. - [Get mailbox sender filters](https://sendmux.ai/docs/api/mailbox-filters/get-mailbox-sender-filters.md): Returns the current sender-filter mode and rule set for a mailbox. Mailbox-scoped rules override any domain-wide rules set on the parent domain. - [Replace mailbox sender filters](https://sendmux.ai/docs/api/mailbox-filters/replace-mailbox-sender-filters.md): Atomically replaces the sender-filter mode and rule set for a mailbox. The entire rule set is swapped in a single operation — there is no intermediate state where the mailbox has a partial ruleset. A maximum of 1000 rules per request is enforced. - [Create a mailbox API key](https://sendmux.ai/docs/api/mailboxes/create-a-mailbox-api-key.md): Mints an additional bearer token plus IMAP/SMTP mailbox password for an existing mailbox. The plaintext key and password are shown exactly once — store them immediately. - [Revoke a mailbox API key](https://sendmux.ai/docs/api/mailboxes/revoke-a-mailbox-api-key.md): Revokes a specific bearer token + matching mailbox password. Idempotent on already-revoked keys. - [List incoming logs](https://sendmux.ai/docs/api/inboxes/list-incoming-logs.md): Returns paginated incoming message logs for billing accountability. - [Get incoming log](https://sendmux.ai/docs/api/inboxes/get-incoming-log.md): Returns one incoming message log by public ID. - [Get sending account statistics](https://sendmux.ai/docs/api/sending-accounts/get-sending-account-statistics.md): Returns aggregate counts of configured sending accounts with breakdowns by type and status. - [Get sending account limits](https://sendmux.ai/docs/api/sending-accounts/get-sending-account-limits.md): Returns custom-account capacity and shared Amazon SES daily sending limit state. - [Request a sending account limit increase](https://sendmux.ai/docs/api/sending-accounts/request-a-sending-account-limit-increase.md): Creates a request to increase the number of custom or connected sending accounts allowed for the team. - [Get shared Amazon SES limit request state](https://sendmux.ai/docs/api/sending-accounts/get-shared-amazon-ses-limit-request-state.md): Returns the shared Amazon SES daily limit state and any pending increase request. - [Request a shared Amazon SES daily limit increase](https://sendmux.ai/docs/api/sending-accounts/request-a-shared-amazon-ses-daily-limit-increase.md): Creates a review request for the shared Amazon SES daily sending limit. This does not modify the limit directly. - [Cancel a shared Amazon SES daily limit request](https://sendmux.ai/docs/api/sending-accounts/cancel-a-shared-amazon-ses-daily-limit-request.md): Cancels a pending shared Amazon SES daily limit increase request for the caller's team. Approved or denied requests cannot be cancelled. - [Get sending account usage](https://sendmux.ai/docs/api/sending-accounts/get-sending-account-usage.md): Returns per-account delivery-log counts for today and the trailing 7-day window. - [List sending accounts](https://sendmux.ai/docs/api/sending-accounts/list-sending-accounts.md): Returns a cursor-paginated list of sending accounts. Credentials are never returned. The shared Amazon SES account is included and marked with `is_shared: true`. - [Create an SMTP sending account](https://sendmux.ai/docs/api/sending-accounts/create-an-smtp-sending-account.md): Creates a custom SMTP sending account. Supply an `Idempotency-Key` header to safely retry on network errors. The SMTP password is stored securely and is never returned. - [Get a sending account](https://sendmux.ai/docs/api/sending-accounts/get-a-sending-account.md): Returns one sending account. Responses include an ETag for conditional GET and optimistic PATCH. - [Update a sending account](https://sendmux.ai/docs/api/sending-accounts/update-a-sending-account.md): Updates a custom sending account or replaces variables on the shared Amazon SES account. Shared-account connection settings cannot be edited; use activate/deactivate and the limit-request endpoint for its other allowed actions. - [Delete a sending account](https://sendmux.ai/docs/api/sending-accounts/delete-a-sending-account.md): Deletes a custom or connected sending account. The shared Amazon SES account cannot be deleted. - [Activate a sending account](https://sendmux.ai/docs/api/sending-accounts/activate-a-sending-account.md): Enables a sending account. OAuth accounts without an active connection are moved to pending until reconnected in the dashboard. The shared Amazon SES account can be activated. - [Deactivate a sending account](https://sendmux.ai/docs/api/sending-accounts/deactivate-a-sending-account.md): Disables a sending account. The shared Amazon SES account can be deactivated. - [Test an SMTP sending account](https://sendmux.ai/docs/api/sending-accounts/test-an-smtp-sending-account.md): Runs a connection test for a custom SMTP account. The shared Amazon SES account and OAuth accounts cannot be tested through this endpoint. - [Get a sending policy](https://sendmux.ai/docs/api/mailboxes/get-a-sending-policy.md): Sender, Reply-To and recipient restrictions intersect across team, inbox and credential policies. Requires an administrative connection: team.read/team.update for team policies, mailbox.admin.read/mailbox.admin.manage for inbox policies, or key.read/key.* for credential policies. Integration and mai… - [Replace a sending policy](https://sendmux.ai/docs/api/mailboxes/replace-a-sending-policy.md): Sender, Reply-To and recipient restrictions intersect across team, inbox and credential policies. Requires an administrative connection: team.read/team.update for team policies, mailbox.admin.read/mailbox.admin.manage for inbox policies, or key.read/key.* for credential policies. Integration and mai… - [Get email metrics](https://sendmux.ai/docs/api/emails/get-email-metrics.md): Returns aggregated email delivery counts with flexible time windowing and comparison period. - [List delivery logs](https://sendmux.ai/docs/api/emails/list-delivery-logs.md): Returns paginated delivery logs with cursor-based pagination and filters. - [Get delivery log](https://sendmux.ai/docs/api/emails/get-delivery-log.md): Returns a single delivery log by its public ID. Responses carry a weak `ETag` header — send it back as `If-None-Match` on the next request and the server will return `304 Not Modified` (no body) when the log has not changed. Logs in a terminal status (sent/failed/rejected) stop changing, so 304 repl… - [Get current balance](https://sendmux.ai/docs/api/billing/get-current-balance.md): Returns the current spendable balance. - [Get spend summary](https://sendmux.ai/docs/api/billing/get-spend-summary.md): Returns a spend summary over a configurable lookback period. - [List transactions](https://sendmux.ai/docs/api/billing/list-transactions.md): Returns paginated credit transaction history with optional type filter. Uses cursor-based pagination ordered by created_at descending — pass `cursor=` from the previous response to fetch the next page. - [List webhook subscriptions](https://sendmux.ai/docs/api/webhooks/list-webhook-subscriptions.md): Returns a cursor-paginated list of webhook subscriptions configured for the team, ordered by `created_at` descending. The signing secret is never included. Pass `cursor=` from the previous response to fetch the next page. - [Create a webhook subscription](https://sendmux.ai/docs/api/webhooks/create-a-webhook-subscription.md): Creates a new webhook subscription and returns the signing secret ONCE in the response body. Store it securely — it cannot be retrieved later. Use `POST /webhooks/{id}/rotate-secret` to issue a new one. - [Get a webhook subscription](https://sendmux.ai/docs/api/webhooks/get-a-webhook-subscription.md): Returns a single webhook subscription. The signing secret is never included. Responses carry a weak `ETag` header — send it back as `If-None-Match` on the next request and the server will return `304 Not Modified` (no body) when the resource has not changed. The same ETag is the value to use in `If-… - [List webhook delivery attempts](https://sendmux.ai/docs/api/webhooks/list-webhook-delivery-attempts.md): Returns recent delivery attempts for one webhook subscription, ordered by `created_at` descending. Delivery metadata is retained for 7 days. Use the payload endpoint while `payload_available` is true to inspect the exact JSON request body that was delivered. - [Get a webhook delivery payload](https://sendmux.ai/docs/api/webhooks/get-a-webhook-delivery-payload.md): Returns the retained JSON request body for one delivery attempt. Payloads are retained for 7 days and may no longer be available after `payload_expires_at`. - [Update a webhook subscription](https://sendmux.ai/docs/api/webhooks/update-a-webhook-subscription.md): Updates the URL, event types, or enabled flag. Any field omitted from the request body is left unchanged. The signing secret is unaffected — use `POST /webhooks/{id}/rotate-secret` to rotate it. - [Delete a webhook subscription](https://sendmux.ai/docs/api/webhooks/delete-a-webhook-subscription.md): Permanently removes the subscription. In-flight retries are dropped. - [Rotate the signing secret](https://sendmux.ai/docs/api/webhooks/rotate-the-signing-secret.md): Generates a fresh signing secret and returns it ONCE. The old secret is immediately invalidated — the next event delivery is signed with the new secret. Store the new value securely; it cannot be retrieved later. - [Send a synthetic test event](https://sendmux.ai/docs/api/webhooks/send-a-synthetic-test-event.md): Publishes a synthetic `sendmux.test` event to this webhook subscription. The subscription must include `"sendmux.test"` in `event_types`, and mailbox filters do not block the test delivery. Returns the generated `event_id` so you can correlate the `X-Qubrics-Event-Id` or `X-Sendmux-Event-Id` header… - [Introduction](https://sendmux.ai/docs/mailbox-api/introduction.md): Mailbox-scoped API endpoints for Qubrics mailbox credentials and connected apps. - [Errors](https://sendmux.ai/docs/mailbox-api/errors.md): Error codes and handling for the Qubrics Mailbox API. - [Get Mailbox connection](https://sendmux.ai/docs/api/mailbox-api/get-mailbox-connection.md): Validate this credential and return its team, connection label, permissions and authorised mailboxes. No additional read permission or mailbox selection is required. Mailbox storage and sending availability are not checked. No user profile or secrets are returned. - [List granted mailboxes](https://sendmux.ai/docs/api/mailbox-api/list-granted-mailboxes.md): Lists the mailboxes available to the current mailbox credential or connected app. Use this before choosing a `mailbox_id` for mailbox actions when more than one mailbox is available. - [Self-introspect the calling mailbox](https://sendmux.ai/docs/api/mailbox-api/self-introspect-the-calling-mailbox.md): Returns the selected mailbox, including live storage usage. Requires a mailbox credential or OAuth grant with Mailbox API access. For credential validation without selecting a mailbox or checking storage, use GET /mailbox/connection. - [Get mailbox API session](https://sendmux.ai/docs/api/mailbox-api/get-mailbox-api-session.md): Returns mailbox API capabilities, resource state tokens, limits, and disabled feature flags for the authenticated mailbox. - [Get permitted sender choices](https://sendmux.ai/docs/api/mailbox-api/get-permitted-sender-choices.md): Intersects current team, inbox and credential policies with provider restrictions and selected delivery groups. Subdomains require separate authorisation. Sending checks these permissions again before submission. - [Get mailbox sender identity](https://sendmux.ai/docs/api/mailbox-api/get-mailbox-sender-identity.md): Returns the default sender identity and signatures for the authenticated mailbox. - [Update mailbox sender identity](https://sendmux.ai/docs/api/mailbox-api/update-mailbox-sender-identity.md): Updates the default sender name, plain text signature, and HTML signature for the authenticated mailbox. - [List mailbox sender identities](https://sendmux.ai/docs/api/mailbox-api/list-mailbox-sender-identities.md): Returns sender identities available to the authenticated mailbox. - [List mailbox messages](https://sendmux.ai/docs/api/mailbox-api/list-mailbox-messages.md): Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access. - [Batch get mailbox messages](https://sendmux.ai/docs/api/mailbox-api/batch-get-mailbox-messages.md): Returns exact messages by ID. Use `body_mode` to choose summary-only output, raw body output, or clean JSON content. Attachment output remains metadata only; attachment contents are not parsed. - [Batch update mailbox messages](https://sendmux.ai/docs/api/mailbox-api/batch-update-mailbox-messages.md): Updates allowed message flags and keywords for up to 100 messages with state-safe conflict handling. - [Batch delete mailbox messages](https://sendmux.ai/docs/api/mailbox-api/batch-delete-mailbox-messages.md): Moves up to 100 messages to Trash by default with state-safe conflict handling. Set `permanent=true` to permanently delete them. - [Count mailbox messages](https://sendmux.ai/docs/api/mailbox-api/count-mailbox-messages.md): Returns a count for the supplied mailbox message filters without returning message rows. - [Get message query changes](https://sendmux.ai/docs/api/mailbox-api/get-message-query-changes.md): Returns filtered message-list index changes since a prior message query state, or the current message query state when omitted. - [Get message search snippets](https://sendmux.ai/docs/api/mailbox-api/get-message-search-snippets.md): Returns subject and preview snippets for a text search. Provide `message_ids` to snippet exact messages, or omit it to snippet the first filtered results. - [Get a mailbox message](https://sendmux.ai/docs/api/mailbox-api/get-a-mailbox-message.md): Returns one message from the authenticated mailbox. Responses include a weak `ETag` header. When attachment metadata includes short-lived download URLs, a conditional request may return `200` even when the stable message ETag matches so the response can renew expired URLs. - [Get raw message body](https://sendmux.ai/docs/api/mailbox-api/get-raw-message-body.md): Returns raw message body content for the authenticated mailbox. This endpoint does not strip signatures, strip quoted replies, extract links, or clean the body into a structured content shape. - [Get clean message content](https://sendmux.ai/docs/api/mailbox-api/get-clean-message-content.md): Returns deterministic clean JSON content for one message. Attachment output is metadata only; attachment contents are not parsed by this endpoint. - [Download the original message](https://sendmux.ai/docs/api/mailbox-api/download-the-original-message.md): Downloads the stored message as an .eml file, including its original headers, body and attachments. Requires access to the selected inbox. Supports conditional requests with If-None-Match. - [Update mailbox message flags](https://sendmux.ai/docs/api/mailbox-api/update-mailbox-message-flags.md): Updates mutable message flags and keywords unconditionally unless `If-Match` is supplied. Send `If-Match` with a prior ETag to reject stale edits. - [Delete a mailbox message](https://sendmux.ai/docs/api/mailbox-api/delete-a-mailbox-message.md): Moves a message to Trash by default, unconditionally unless `If-Match` is supplied. Set `permanent=true` to permanently delete it. Send `If-Match` with a prior ETag to reject stale deletes. - [Send a mailbox message](https://sendmux.ai/docs/api/mailbox-api/send-a-mailbox-message.md): Creates and queues a message from the authenticated mailbox. Supply an `Idempotency-Key` header to safely retry. Attachments may use small inline base64 content or blob IDs returned by `POST /mailbox/attachments:upload` or `POST /mailbox/attachment-uploads`. - [List saved drafts](https://sendmux.ai/docs/api/mailbox-api/list-saved-drafts.md) - [Create a saved draft](https://sendmux.ai/docs/api/mailbox-api/create-a-saved-draft.md) - [Read a saved draft](https://sendmux.ai/docs/api/mailbox-api/read-a-saved-draft.md) - [Edit a saved draft](https://sendmux.ai/docs/api/mailbox-api/edit-a-saved-draft.md) - [Delete a saved draft](https://sendmux.ai/docs/api/mailbox-api/delete-a-saved-draft.md) - [Send a saved draft revision](https://sendmux.ai/docs/api/mailbox-api/send-a-saved-draft-revision.md) - [Reschedule or cancel a saved draft send](https://sendmux.ai/docs/api/mailbox-api/reschedule-or-cancel-a-saved-draft-send.md) - [Upload a mailbox attachment](https://sendmux.ai/docs/api/mailbox-api/upload-a-mailbox-attachment.md): Uploads one attachment as binary data and returns a blob ID that can be supplied to `POST /mailbox/messages/send`. - [Create a presigned mailbox attachment upload](https://sendmux.ai/docs/api/mailbox-api/create-a-presigned-mailbox-attachment-upload.md): Creates a short-lived signed PUT URL for one attachment. The caller must be authenticated to mint the URL; the later PUT uses the signed URL, exact Content-Type, and exact Content-Length without sending a bearer token. The PUT returns a blob ID that can be supplied to `POST /mailbox/messages/send`. - [Download a message attachment](https://sendmux.ai/docs/api/mailbox-api/download-a-message-attachment.md): Streams one attachment from a message through the authenticated endpoint. Attachment metadata also provides short-lived download URLs for clients that cannot set request headers. Supports standard byte ranges. - [Request attachment text](https://sendmux.ai/docs/api/mailbox-api/request-attachment-text.md): Extract readable text from an attachment up to 7500000 bytes, at no extra charge. Repeating this request reuses the same current source extraction for 24 hours; no request body or Idempotency-Key is needed. Conversion runs for at most 30 seconds. OCR is unavailable. Current mailbox access and the so… - [Read attachment text](https://sendmux.ai/docs/api/mailbox-api/read-attachment-text.md): Read or poll a requested extraction. Returns 404 after cache expiry or source removal. Current access and source availability are checked even with If-None-Match. This request does not start a conversion. - [List mailbox threads](https://sendmux.ai/docs/api/mailbox-api/list-mailbox-threads.md): Returns a cursor-paginated list of conversation threads for the authenticated mailbox. Filter by text, participant, folder, unread state, attachment presence, or date range. - [Get a mailbox thread](https://sendmux.ai/docs/api/mailbox-api/get-a-mailbox-thread.md): Returns thread metadata, message IDs, participants, last message, unread count, and state for one conversation. Responses include a weak `ETag` header. - [List thread messages](https://sendmux.ai/docs/api/mailbox-api/list-thread-messages.md): Returns cursor-paginated message summaries for one thread. Use the thread content endpoint when you need cleaned bodies. - [Get clean thread content](https://sendmux.ai/docs/api/mailbox-api/get-clean-thread-content.md): Returns a cursor-paginated clean JSON view of messages in a thread. Attachment output is metadata only; attachment contents are not parsed by this endpoint. - [List mailbox folders](https://sendmux.ai/docs/api/mailbox-api/list-mailbox-folders.md): Returns a cursor-paginated list of folders for the authenticated mailbox. - [Create a mailbox folder](https://sendmux.ai/docs/api/mailbox-api/create-a-mailbox-folder.md): Creates a folder in the authenticated mailbox. - [Get folder changes](https://sendmux.ai/docs/api/mailbox-api/get-folder-changes.md): Returns folder changes since a prior folder state, or the current folder state when omitted. - [Get folder query changes](https://sendmux.ai/docs/api/mailbox-api/get-folder-query-changes.md): Returns folder-list index changes since a prior folder query state, or the current folder query state when omitted. - [Get a mailbox folder](https://sendmux.ai/docs/api/mailbox-api/get-a-mailbox-folder.md): Returns one folder from the authenticated mailbox. Responses include a weak `ETag` header. - [Update a mailbox folder](https://sendmux.ai/docs/api/mailbox-api/update-a-mailbox-folder.md): Updates a folder unconditionally unless `If-Match` is supplied. Send `If-Match` with a prior ETag to reject stale edits. - [Delete a mailbox folder](https://sendmux.ai/docs/api/mailbox-api/delete-a-mailbox-folder.md): Deletes an empty custom folder unconditionally unless `If-Match` is supplied. Built-in folders and non-empty folders cannot be deleted. Send `If-Match` with a prior ETag to reject stale deletes. - [List calendars](https://sendmux.ai/docs/api/mailbox-api/list-calendars.md) - [Create a private calendar](https://sendmux.ai/docs/api/mailbox-api/create-a-private-calendar.md) - [Get a calendar](https://sendmux.ai/docs/api/mailbox-api/get-a-calendar.md) - [Delete an empty calendar](https://sendmux.ai/docs/api/mailbox-api/delete-an-empty-calendar.md): Fetch the calendar and supply its ETag in If-Match. A calendar containing events returns 409 conflict. - [List calendar events](https://sendmux.ai/docs/api/mailbox-api/list-calendar-events.md): UID search is eventually consistent. An empty immediate lookup leaves an uncertain create unresolved and never authorises repeating it. - [Create a non-sending event](https://sendmux.ai/docs/api/mailbox-api/create-a-non-sending-event.md): Creates one event without participants, recurrence or alerts. Invitations and scheduling messages are disabled. Retain UID before dispatch. If creation is uncertain, use read-only UID lookup; do not repeat the create. - [Get a calendar event](https://sendmux.ai/docs/api/mailbox-api/get-a-calendar-event.md) - [Update a non-sending event](https://sendmux.ai/docs/api/mailbox-api/update-a-non-sending-event.md) - [Delete a non-sending event](https://sendmux.ai/docs/api/mailbox-api/delete-a-non-sending-event.md) - [Get calendar event changes](https://sendmux.ai/docs/api/mailbox-api/get-calendar-event-changes.md): Coalesced changes for synchronisation, not a lossless mutation history. Missing or expired state requires a full list refresh; establish a new baseline before listing and then consume changes to cover concurrent edits. - [List mailbox submissions](https://sendmux.ai/docs/api/mailbox-api/list-mailbox-submissions.md): Returns a cursor-paginated list of send submissions for the authenticated mailbox, including delivery lifecycle fields when available. - [Get submission changes](https://sendmux.ai/docs/api/mailbox-api/get-submission-changes.md): Returns send submission changes since a prior submission state, or the current state when omitted. - [Get a mailbox submission](https://sendmux.ai/docs/api/mailbox-api/get-a-mailbox-submission.md): Returns one send submission for the authenticated mailbox. Responses include a weak `ETag` header. - [List mailbox quotas](https://sendmux.ai/docs/api/mailbox-api/list-mailbox-quotas.md): Returns a cursor-paginated list of quota usage and limits for the authenticated mailbox. - [Get quota changes](https://sendmux.ai/docs/api/mailbox-api/get-quota-changes.md): Returns quota changes since a prior quota state, or the current quota state when omitted. - [Get mailbox usage](https://sendmux.ai/docs/api/mailbox-api/get-mailbox-usage.md): Returns a compact usage view derived from mailbox quota records. Responses include a weak `ETag` header. - [Get mailbox changes](https://sendmux.ai/docs/api/mailbox-api/get-mailbox-changes.md): Returns message changes in the legacy shape when `types` is omitted. Pass a comma-separated `types` list for a typed state map. - [Stream mailbox events](https://sendmux.ai/docs/api/mailbox-api/stream-mailbox-events.md): Streams bounded rich mailbox events for connected clients. Each received-message event includes subject, participants, preview, attachment metadata, and a capped body snapshot; use the message endpoints for full content or attachment bytes. - [Introduction](https://sendmux.ai/docs/sending-api/introduction.md): Send emails programmatically via the Qubrics Sending API. - [Errors](https://sendmux.ai/docs/sending-api/errors.md): Error codes and handling for the Qubrics Sending API. - [Get Sending connection](https://sendmux.ai/docs/api/meta/get-sending-connection.md): Validate this Sending credential and return its team, connection label, permissions and authorised mailboxes. Requires email.send. Credits, provider readiness and mailbox storage are not checked. No user profile or secrets are returned. - [Send a single email](https://sendmux.ai/docs/api/emails/send-a-single-email.md): Queue a single email for delivery. Requires `email.send` permission. - [Send a batch of emails](https://sendmux.ai/docs/api/emails/send-a-batch-of-emails.md): Queue up to 100 emails for delivery in a single request. Uses partial success model — individual message failures do not fail the entire batch. Requires `email.send` permission. - [Upload an attachment](https://sendmux.ai/docs/api/attachments/upload-an-attachment.md): Upload binary attachment bytes and receive a temporary attachment_id for use in attachments[]. Requires `email.send` permission. - [Get attachment metadata](https://sendmux.ai/docs/api/attachments/get-attachment-metadata.md): Return metadata for a temporary uploaded attachment owned by the authenticated team. File bytes are not returned. - [Create an attachment upload URL](https://sendmux.ai/docs/api/attachments/create-an-attachment-upload-url.md): Create a short-lived upload URL and token that lets a remote client PUT one binary attachment without exposing the API key on the upload request. Requires `email.send` permission. - [Upload bytes to an attachment upload URL](https://sendmux.ai/docs/api/attachments/upload-bytes-to-an-attachment-upload-url.md): Upload the exact binary bytes for a previously-created attachment upload URL. This operation uses the short-lived upload token header returned by POST /emails/attachment-uploads, not a Sendmux API key. ## OpenAPI Specs - [openapi-app](/docs/openapi-app.json) - [openapi-sending](/docs/openapi-sending.json) ## Optional - [App](https://app.qubrics.com) - [Website](https://qubrics.com) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.