Send email and manage temporary sending attachments
Headers
Idempotency-Key
string
Optional client-generated key to make the request idempotent for 24 hours. Replays under the same key return the cached response; a reused key with a different body returns 409 idempotency_conflict.
Maximum string length: 255
Body
application/json
from
object
required
Sender address
Hide child attributes
from.email
string<email>
required
Email address
Maximum string length: 254
Example:
"user@example.com"
from.name
string
Display name
Maximum string length: 100
Pattern: ^[^\r\n]*$
Example:
"John Smith"
html_body
string
required
HTML email content (max 25MB)
Required string length: 1 - 26214400
subject
string
required
Email subject line (max 998 chars, RFC 5322)
Required string length: 1 - 998
Pattern: ^[^\r\n]*$
Example:
"Welcome to Sendmux"
to
object
required
Primary recipient
Hide child attributes
to.email
string<email>
required
Email address
Maximum string length: 254
Example:
"user@example.com"
to.name
string
Display name
Maximum string length: 100
Pattern: ^[^\r\n]*$
Example:
"John Smith"
attachments
object[]
File attachments (max 10). Use attachment_id refs for uploaded files.
Maximum array length: 10
Option 1
Option 2
Hide child attributes
attachments.content
string
required
Base64-encoded file content
Minimum string length: 1
attachments.filename
string
required
Filename with allowed extension
Required string length: 1 - 255
Example:
"invoice.pdf"
attachments.encoding
enum<string>
default:base64
Available options:
base64
attachments.type
string
MIME type override
Example:
"application/pdf"
bcc
object[]
BCC recipients (subject to 50 total To, CC, and BCC recipients)
Maximum array length: 49
Hide child attributes
bcc.email
string<email>
required
Recipient email address
Maximum string length: 254
bcc.name
string
Recipient display name
Maximum string length: 100
Pattern: ^[^\r\n]*$
cc
object[]
CC recipients (subject to 50 total To, CC, and BCC recipients)
Maximum array length: 49
Hide child attributes
cc.email
string<email>
required
Recipient email address
Maximum string length: 254
cc.name
string
Recipient display name
Maximum string length: 100
Pattern: ^[^\r\n]*$
custom_headers
object
Custom X-* headers to include in the email
Hide child attributes
custom_headers.{key}
string
Maximum string length: 500
Pattern: ^[^\r\n]*$
delivery_group
stringstring[]
One delivery group public ID or a non-empty array of up to 50 IDs
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Qubrics","description":"The intelligent email layer","colors":{"primary":"#6a75f1","light":"#5a84e9","dark":"#004aad"},"logo":{"light":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967","dark":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=612f5f9e57f97fd13812a619d185a2f9","href":"https://qubrics.com/docs"},"favicon":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967","api":{"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"autogenerate":true}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"/changelog","label":"Changelog"},{"href":"mailto:contact@qubrics.com","label":"Support"}],"primary":{"type":"button","label":"App","href":"https://app.qubrics.com"}},"footer":{"socials":{"x":"https://x.com/sendmux","github":"https://github.com/qubrics"}},"seo":{"metatags":{"canonical":"https://qubrics.com/docs"}},"fonts":{"family":"Lato","weight":400},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","href":"https://app.qubrics.com"},{"anchor":"Website","href":"https://qubrics.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendmux","hasAudioNarration":false,"actualSubdomain":"sendmux","customDomains":["sendmux.ai"],"gitSource":{"type":"github","owner":"qubrics","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{},"buildId":"6afbb1b8a017c34cfd2fe8fa","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Guides","count":80},{"language":"default","tag":"Mailbox API","count":65},{"language":"default","tag":"Management API","count":58},{"language":"default","tag":"AI integrations","count":32},{"language":"default","tag":"MCP","count":23},{"language":"default","tag":"Client setup","count":23},{"language":"default","tag":"Developer tools","count":21},{"language":"default","tag":"Sending accounts","count":18},{"language":"default","tag":"Mailboxes","count":15},{"language":"default","tag":"Messages","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{font-size:103%}.antialiased{-webkit-font-smoothing:auto!important;-moz-osx-font-smoothing:auto!important}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6,.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{letter-spacing:var(--tracking-tight)!important}body,.prose,.prose p,.prose li,.prose td,.prose th,.prose blockquote{letter-spacing:0.00625rem!important}.eyebrow.h-5{text-transform:uppercase;letter-spacing:0.063em!important}h3.sidebar-title,#sidebar-title{display:flex;align-items:center;height:1.75rem;color:oklch(0.345 0.006 264 / 60%);text-transform:uppercase;font-size:0.7rem;font-weight:400;letter-spacing:0.044rem!important}.dark h3.sidebar-title,.dark #sidebar-title{color:oklch(0.985 0.001 106.423 / 60%)}"}],"page":{"pagePath":"api/emails/send-a-single-email","slug":"/api/emails/send-a-single-email","pageMetadata":{"title":"Send a single email","description":"Queue a single email for delivery. Requires `email.send` permission.","deprecated":null,"version":null,"openapi":"/openapi-sending.json post /emails/send","href":"/api/emails/send-a-single-email","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Queue a single email for delivery. Requires \", _jsx(_components.code, {\n children: \"email.send\"\n }), \" permission.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Send a single email","description":"Queue a single email for delivery. Requires `email.send` permission.","deprecated":null,"version":null,"openapi":"/openapi-sending.json post /emails/send","href":"/api/emails/send-a-single-email","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Queue a single email for delivery. Requires `email.send` permission.","operationId":"sendingSendEmail","parameters":["8757a591-102f-4caf-8cb3-c923f069fb90"],"requestBody":"d4bec060-d1c6-4470-90ba-6e3d79c2958c","responses":{"200":"1e7b8821-0804-4dbd-a85d-aa7f4ef8907c","400":"9c967a69-d8be-4201-adca-9b535e3c3e23","401":"938c9aaa-356e-4e4e-9216-bb6e6236de95","402":"64f48dbc-0c95-47b3-be5d-b6d1349e77d5","403":"7d8416ce-2a48-4576-b29a-370b58e73d54","409":"20511ac5-0163-40b3-ab26-483782abda2d","413":"a659922c-3ff5-4e6c-8a8a-26584e969273","422":"6cf3386f-4664-46dc-8097-d339673a6612","429":"e29ee304-4eaa-4e71-a238-c1fa4f2a49e6","503":"db175443-4a17-491f-865f-e938c17dae75"},"security":["c2cdbeca-4db2-487e-ab87-a8e24c602132","f7801e62-2a28-41d0-82dd-0029cc721dce"],"summary":"Send a single email","tags":["Emails"],"method":"post","type":"path","servers":["e6775ce1-42a3-46ac-9316-1c41d7fde7bd"],"path":"/emails/send","baseUrlOptions":["https://smtp.sendmux.ai/api/v1"],"title":"Send a single email","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8757a591-102f-4caf-8cb3-c923f069fb90":{"description":"Optional client-generated key to make the request idempotent for 24 hours. Replays under the same key return the cached response; a reused key with a different body returns 409 idempotency_conflict.","example":"order-12345-2026-04-24","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":255,"type":"string","isRequired":false,"description":"Optional client-generated key to make the request idempotent for 24 hours. Replays under the same key return the cached response; a reused key with a different body returns 409 idempotency_conflict.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"from":{"additionalProperties":false,"description":"Sender address","properties":{"email":{"description":"Email address","example":"user@example.com","format":"email","maxLength":254,"type":"string","isRequired":true,"uniqueKey":"from.email","typeLabel":"string\u003cemail>"},"name":{"description":"Display name","example":"John Smith","maxLength":100,"pattern":"^[^\\r\\n]*$","type":"string","uniqueKey":"from.name","typeLabel":"string"}},"required":["email"],"type":"object","isRequired":true,"uniqueKey":"from","typeLabel":"object"},"html_body":{"description":"HTML email content (max 25MB)","maxLength":26214400,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"html_body","typeLabel":"string"},"subject":{"description":"Email subject line (max 998 chars, RFC 5322)","example":"Welcome to Sendmux","maxLength":998,"minLength":1,"pattern":"^[^\\r\\n]*$","type":"string","isRequired":true,"uniqueKey":"subject","typeLabel":"string"},"to":{"type":"object","description":"Primary recipient","required":["email"],"properties":{"email":{"description":"Email address","example":"user@example.com","format":"email","maxLength":254,"type":"string","isRequired":true,"uniqueKey":"to.email","typeLabel":"string\u003cemail>"},"name":{"description":"Display name","example":"John Smith","maxLength":100,"pattern":"^[^\\r\\n]*$","type":"string","uniqueKey":"to.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"to","typeLabel":"object"},"attachments":{"description":"File attachments (max 10). Use attachment_id refs for uploaded files.","items":{"oneOf":[{"type":"object","required":["filename","content"],"properties":{"content":{"description":"Base64-encoded file content","minLength":1,"type":"string","isRequired":true,"uniqueKey":"attachments.items.[INDEX].oneOf.0.content","typeLabel":"string"},"filename":{"description":"Filename with allowed extension","example":"invoice.pdf","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"attachments.items.[INDEX].oneOf.0.filename","typeLabel":"string"},"encoding":{"default":"base64","enum":["base64"],"type":"string","uniqueKey":"attachments.items.[INDEX].oneOf.0.encoding","typeLabel":"enum\u003cstring>"},"type":{"description":"MIME type override","example":"application/pdf","type":"string","uniqueKey":"attachments.items.[INDEX].oneOf.0.type","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"attachments.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["attachment_id"],"properties":{"attachment_id":{"description":"Temporary uploaded attachment ID returned by POST /emails/attachments.","example":"att_tz4a98xxat96iws9zmbrgj3a","pattern":"^att_[a-z0-9]{24}$","type":"string","isRequired":true,"uniqueKey":"attachments.items.[INDEX].oneOf.1.attachment_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"attachments.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"attachments.items.[INDEX]","typeLabel":"object"},"maxItems":10,"type":"array","uniqueKey":"attachments","typeLabel":"object[]"},"bcc":{"description":"BCC recipients (subject to 50 total To, CC, and BCC recipients)","items":{"additionalProperties":false,"properties":{"email":{"description":"Recipient email address","format":"email","maxLength":254,"type":"string","isRequired":true,"uniqueKey":"bcc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"description":"Recipient display name","maxLength":100,"pattern":"^[^\\r\\n]*$","type":"string","uniqueKey":"bcc.items.[INDEX].name","typeLabel":"string"}},"required":["email"],"type":"object","uniqueKey":"bcc.items.[INDEX]","typeLabel":"object"},"maxItems":49,"type":"array","uniqueKey":"bcc","typeLabel":"object[]"},"cc":{"description":"CC recipients (subject to 50 total To, CC, and BCC recipients)","items":{"additionalProperties":false,"properties":{"email":{"description":"Recipient email address","format":"email","maxLength":254,"type":"string","isRequired":true,"uniqueKey":"cc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"description":"Recipient display name","maxLength":100,"pattern":"^[^\\r\\n]*$","type":"string","uniqueKey":"cc.items.[INDEX].name","typeLabel":"string"}},"required":["email"],"type":"object","uniqueKey":"cc.items.[INDEX]","typeLabel":"object"},"maxItems":49,"type":"array","uniqueKey":"cc","typeLabel":"object[]"},"custom_headers":{"additionalProperties":{"maxLength":500,"pattern":"^[^\\r\\n]*$","type":"string","uniqueKey":"custom_headers.additionalProperties","typeLabel":"string"},"description":"Custom X-* headers to include in the email","type":"object","uniqueKey":"custom_headers","typeLabel":"object"},"delivery_group":{"oneOf":[{"type":"string","description":"One delivery group public ID or a non-empty array of up to 50 IDs","pattern":"^dgrp_[a-z0-9][a-z0-9_-]{0,122}$","uniqueKey":"delivery_group.oneOf.0","typeLabel":"string"},{"type":"array","items":{"pattern":"^dgrp_[a-z0-9][a-z0-9_-]{0,122}$","type":"string","uniqueKey":"delivery_group.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"One delivery group public ID or a non-empty array of up to 50 IDs","maxItems":50,"minItems":1,"uniqueKey":"delivery_group.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"delivery_group","typeLabel":"string | string[]"},"reply_to":{"type":"object","description":"Reply-To address","required":["email"],"properties":{"email":{"description":"Email address","example":"user@example.com","format":"email","maxLength":254,"type":"string","isRequired":true,"uniqueKey":"reply_to.email","typeLabel":"string\u003cemail>"},"name":{"description":"Display name","example":"John Smith","maxLength":100,"pattern":"^[^\\r\\n]*$","type":"string","uniqueKey":"reply_to.name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"reply_to","typeLabel":"object"},"return_path":{"description":"Envelope sender for VERP support","format":"email","maxLength":254,"type":"string","uniqueKey":"return_path","typeLabel":"string\u003cemail>"},"text_body":{"description":"Plain text alternative (max 25MB)","maxLength":26214400,"type":"string","uniqueKey":"text_body","typeLabel":"string"}},"required":["from","to","subject","html_body"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"from":{"email":"user@example.com","name":"John Smith"},"html_body":"\u003cstring>","subject":"Welcome to Sendmux","to":{"email":"user@example.com","name":"John Smith"},"attachments":[{"content":"\u003cstring>","filename":"invoice.pdf","encoding":"base64","type":"application/pdf"}],"bcc":[{"email":"jsmith@example.com","name":"\u003cstring>"}],"cc":[{"email":"jsmith@example.com","name":"\u003cstring>"}],"custom_headers":{},"delivery_group":"\u003cstring>","return_path":"jsmith@example.com","text_body":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"1e7b8821-0804-4dbd-a85d-aa7f4ef8907c":{"content":{"application/json":{"schema":{"type":"object","required":["data","ok","meta"],"properties":{"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[true],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"data":{"additionalProperties":false,"properties":{"message_id":{"description":"Unique message identifier (eml_ prefix + 24 alphanumeric chars)","example":"eml_tz4a98xxat96iws9zmbrgj3a","pattern":"^eml_[a-z0-9]{24}$","type":"string","isRequired":true,"uniqueKey":"data.message_id","typeLabel":"string"},"status":{"description":"Message queuing status","enum":["queued"],"type":"string","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"}},"required":["message_id","status"],"type":"object","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":true,"data":{"message_id":"eml_tz4a98xxat96iws9zmbrgj3a","status":"queued"}}}},"exampleType":"generated"}},"description":"Email queued successfully","exampleType":"generated"},"9c967a69-d8be-4201-adca-9b535e3c3e23":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Malformed request (invalid JSON or syntactic parameter error)","exampleType":"generated"},"938c9aaa-356e-4e4e-9216-bb6e6236de95":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Authentication required","exampleType":"generated"},"64f48dbc-0c95-47b3-be5d-b6d1349e77d5":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Insufficient credits","exampleType":"generated"},"7d8416ce-2a48-4576-b29a-370b58e73d54":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Insufficient permissions","exampleType":"generated"},"20511ac5-0163-40b3-ab26-483782abda2d":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Idempotency conflict (Idempotency-Key reused with different body, or request already in flight)","exampleType":"generated"},"a659922c-3ff5-4e6c-8a8a-26584e969273":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Request body exceeds 25 MB","exampleType":"generated"},"6cf3386f-4664-46dc-8097-d339673a6612":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Validation error (schema failures, accumulated in error.errors[])","exampleType":"generated"},"e29ee304-4eaa-4e71-a238-c1fa4f2a49e6":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Rate limit exceeded or Free daily sending limit reached (Retry-After header included)","exampleType":"generated"},"db175443-4a17-491f-865f-e938c17dae75":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","example":"validation_error","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"True when the client may safely retry the same request. 429 and 5xx default true; 4xx default false.","type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to error documentation","format":"uri","type":"string","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"},"errors":{"description":"Accumulated per-field issues (validation errors)","items":{"additionalProperties":false,"properties":{"code":{"description":"Issue code from the validator","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path to the failing field","example":"to.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue message","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"Parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"description":"Unique request identifier","example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryable":true,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"to.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Service unavailable (Retry-After header included)","exampleType":"generated"}},"security":{"c2cdbeca-4db2-487e-ab87-a8e24c602132":{"BearerAuth":{"description":"Sendmux API key (smx_...)","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}},"f7801e62-2a28-41d0-82dd-0029cc721dce":{"OAuth2":{"description":"Use the authorisation-code flow with S256 PKCE and resource=https://sendmux.ai/api. The user must grant Sending API access and email.send. OAuth access tokens authenticate HTTP requests; use a send-capable API key for SMTP.","flows":{"authorizationCode":{"authorizationUrl":"https://app.sendmux.ai/oauth/authorize","refreshUrl":"https://app.sendmux.ai/oauth/token","scopes":{"email.send":"Send email and manage temporary sending attachments"},"tokenUrl":"https://app.sendmux.ai/oauth/token"}},"type":"oauth2","scopes":["email.send"],"schemeName":"OAuth2"}}},"servers":{"e6775ce1-42a3-46ac-9316-1c41d7fde7bd":{"description":"Production","url":"https://smtp.sendmux.ai/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Sendmux API key (smx_...)","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Sendmux API key (smx_...)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"description":"Use the authorisation-code flow with S256 PKCE and resource=https://sendmux.ai/api. The user must grant Sending API access and email.send. OAuth access tokens authenticate HTTP requests; use a send-capable API key for SMTP.","flows":{"authorizationCode":{"authorizationUrl":"https://app.sendmux.ai/oauth/authorize","refreshUrl":"https://app.sendmux.ai/oauth/token","scopes":{"email.send":"Send email and manage temporary sending attachments"},"tokenUrl":"https://app.sendmux.ai/oauth/token"}},"type":"oauth2","scopes":["email.send"],"schemeName":"OAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Use the authorisation-code flow with S256 PKCE and resource=https://sendmux.ai/api. The user must grant Sending API access and email.send. OAuth access tokens authenticate HTTP requests; use a send-capable API key for SMTP.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2","name":"Authorization"}],"title":"OAuth2"}]},"originalFileLocation":"openapi-sending.json"},"subdomain":"sendmux","siteName":"Qubrics","title":"Send a single email - Qubrics","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T04:36:28.597Z","originalFileLocation":"api/emails/send-a-single-email.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Queue a single email for delivery. Requires email.send permission.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Qubrics\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send a single email - Qubrics\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queue a single email for delivery. Requires email.send permission.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Qubrics\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://qubrics.com/docs/api/emails/send-a-single-email\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sendmux.mintlify.site/docs/_mintlify/api/og/v2?division=Emails\u0026amp;title=Send+a+single+email\u0026amp;description=Queue+a+single+email+for+delivery.+Requires+%60email.send%60+permission.\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=6c8352c6ecc3517ed1d9ea2e5f0ee40cf51b2a7c578b493da68b267d7ef1b3a5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Send a single email - Qubrics\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queue a single email for delivery. Requires email.send permission.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sendmux.mintlify.site/docs/_mintlify/api/og/v2?division=Emails\u0026amp;title=Send+a+single+email\u0026amp;description=Queue+a+single+email+for+delivery.+Requires+%60email.send%60+permission.\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=6c8352c6ecc3517ed1d9ea2e5f0ee40cf51b2a7c578b493da68b267d7ef1b3a5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/F4atzrrDO9okNEWg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Qubrics\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6a75f1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://qubrics.com/docs/api/emails/send-a-single-email\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api/emails/send-a-single-email.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://qubrics.com/#organization\",\"name\":\"Qubrics\",\"url\":\"https://qubrics.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967\"}},{\"@type\":\"WebSite\",\"@id\":\"https://qubrics.com/docs#website\",\"name\":\"Qubrics\",\"url\":\"https://qubrics.com/docs\",\"publisher\":{\"@id\":\"https://qubrics.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://qubrics.com/docs/api/emails/send-a-single-email#webpage\",\"url\":\"https://qubrics.com/docs/api/emails/send-a-single-email\",\"name\":\"Send a single email\",\"description\":\"Queue a single email for delivery. Requires email.send permission.\",\"dateModified\":\"2026-11-03T04:36:28.597Z\",\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://qubrics.com/docs/api/emails/send-a-single-email#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://qubrics.com/docs/api/emails/send-a-single-email#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Qubrics\",\"item\":\"https://qubrics.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Send a single email\",\"item\":\"https://qubrics.com/docs/api/emails/send-a-single-email\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://qubrics.com/docs/api/emails/send-a-single-email#apireference\",\"headline\":\"Send a single email\",\"name\":\"Send a single email\",\"description\":\"Queue a single email for delivery. Requires email.send permission.\",\"url\":\"https://qubrics.com/docs/api/emails/send-a-single-email\",\"mainEntityOfPage\":{\"@id\":\"https://qubrics.com/docs/api/emails/send-a-single-email#webpage\"},\"dateModified\":\"2026-11-03T04:36:28.597Z\",\"publisher\":{\"@id\":\"https://qubrics.com/#organization\"},\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Qubrics\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Qubrics\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api/emails/send-a-single-email.md","siteName":"Qubrics","nav":{"global":{"anchors":[{"anchor":"App","href":"https://app.qubrics.com"},{"anchor":"Website","href":"https://qubrics.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Management API","pages":[{"title":"Management API","href":"/api/introduction"}]},{"tab":"Mailbox API","pages":[{"title":"Mailbox API","href":"/mailbox-api/introduction"}]},{"tab":"Sending API","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/sending-api/introduction"},{"title":"Errors","href":"/sending-api/errors"},{"title":"Get Sending connection","description":"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.","deprecated":null,"version":null,"openapi":"/openapi-sending.json get /me","href":"/api/meta/get-sending-connection"}]},{"group":"Emails","pages":[{"title":"Send a single email","deprecated":null,"version":null,"openapi":"/openapi-sending.json post /emails/send","href":"/api/emails/send-a-single-email"},{"title":"Send a batch of emails","description":"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.","deprecated":null,"version":null,"openapi":"/openapi-sending.json post /emails/send/batch","href":"/api/emails/send-a-batch-of-emails"}]},{"group":"Attachments","pages":[{"title":"Upload an attachment","deprecated":null,"version":null,"openapi":"/openapi-sending.json post /emails/attachments","href":"/api/attachments/upload-an-attachment"},{"title":"Get attachment metadata","deprecated":null,"version":null,"openapi":"/openapi-sending.json get /emails/attachments/{attachment_id}","href":"/api/attachments/get-attachment-metadata"},{"title":"Create an attachment upload URL","deprecated":null,"version":null,"openapi":"/openapi-sending.json post /emails/attachment-uploads","href":"/api/attachments/create-an-attachment-upload-url"},{"title":"Upload bytes to an attachment upload URL","deprecated":null,"version":null,"openapi":"/openapi-sending.json put /emails/attachment-uploads/{upload_id}","href":"/api/attachments/upload-bytes-to-an-attachment-upload-url"}]}]}]},"basePath":"","title":"Send a single email - Qubrics","buildId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","deploymentId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Cy2NURoQ.js","utils-CTKFcKhQ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Dbtv_wCw.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DYh_uLft.js","snippetPresets-DxwpEH1-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-D9KrOqxg.js","ApiExamples-clm-D0kL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BBf1wA6D.js","shallow-BToikfmA.js","getApiPlaygroundDisplay-pkRLxJ6E.js","CodeSnippet-CSk3BdcJ.js","CodeSnippets-Dy5u3aPE.js","getPastedJson-DNhwlub0.js","icon-DBGzFdPQ.js","MethodPill-CdyVkQoM.js","DuplicateIcon-DEe2SEjX.js","createIcon-BnnV9h2U.js","DynamicMarkdown-DcvJmTWC.js","SectionHeading-C5-ljYUo.js","axios-vUo_bRtp.js","Markdown-CNKtyJ6_.js","dist-f_--J3AN.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-BDxDyTJx.js"]}