{ "status": "success", "message": "Email queued for delivery"}
Email Sending
Send transactional email
Sends transactional emails to specified recipients with support for personalization, attachments, and tracking.
The API validates the request synchronously and returns 202 Accepted when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response.
Optional headers:List-Unsubscribe (passed through for list-unsubscribe), X-SendPost-Mock-Email: true (mock send, if supported).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SendX Docs","colors":{"primary":"#ffd700","light":"#ffd700","dark":"#ffaa00"},"logo":{"light":"https://mintcdn.com/sendx-31f00733/3nIKI_xln-0gUAbn/logo/light.svg?fit=max\u0026auto=format\u0026n=3nIKI_xln-0gUAbn\u0026q=85\u0026s=5ce863c22b88897598d8f817e4420c6d","dark":"https://mintcdn.com/sendx-31f00733/3nIKI_xln-0gUAbn/logo/dark.svg?fit=max\u0026auto=format\u0026n=3nIKI_xln-0gUAbn\u0026q=85\u0026s=92d7a2d0308e90e285be961ebcd78e01"},"favicon":"https://mintcdn.com/sendx-31f00733/3nIKI_xln-0gUAbn/favicon.svg?fit=max\u0026auto=format\u0026n=3nIKI_xln-0gUAbn\u0026q=85\u0026s=d0f924b5471196116b6f44d8bf8393f7","navbar":{"links":[{"href":"mailto:support@sendx.io","label":"Support"}],"primary":{"type":"button","label":"SendX","href":"https://app.sendx.io/"}},"footer":{"socials":{"x":"https://x.com/sendxio","github":"https://github.com/sendx","linkedin":"https://www.linkedin.com/company/sendx","youtube":"https://www.youtube.com/@sendxio"}},"integrations":{"intercom":{"appId":"APP_ID"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendx-31f00733","hasAudioNarration":false,"actualSubdomain":"sendx-31f00733","customDomains":["docs.sendx.io"],"gitSource":{"type":"github","owner":"sendx","repo":"sendx-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae32e4ffa750f9207825750","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":75},{"language":"default","tag":"Welcome","count":12},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"Webhook","count":7},{"language":"default","tag":"Quickstart","count":7},{"language":"default","tag":"Contact","count":6},{"language":"default","tag":"Custom Field","count":5},{"language":"default","tag":"List","count":5},{"language":"default","tag":"Post Category","count":5},{"language":"default","tag":"Post Tag","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/email-sending/send-transactional-email","slug":"/api-reference/email-sending/send-transactional-email","pageMetadata":{"openapi":"post /send/email","title":"Send transactional email","description":"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking.\n\nThe API validates the request synchronously and returns **202 Accepted** when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response.\n\n**Optional headers:** `List-Unsubscribe` (passed through for list-unsubscribe), `X-SendPost-Mock-Email: true` (mock send, if supported).\n","href":"/api-reference/email-sending/send-transactional-email"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The API validates the request synchronously and returns \", _jsx(_components.strong, {\n children: \"202 Accepted\"\n }), \" when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Optional headers:\"\n }), \" \", _jsx(_components.code, {\n children: \"List-Unsubscribe\"\n }), \" (passed through for list-unsubscribe), \", _jsx(_components.code, {\n children: \"X-SendPost-Mock-Email: true\"\n }), \" (mock send, if supported).\"]\n })]\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`🎯 Key Features:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Send to multiple recipients with CC/BCC support`}),`\n`,_jsx(_components.li,{children:`HTML, plain text, and AMP content`}),`\n`,_jsx(_components.li,{children:`Custom headers and tracking options`}),`\n`,_jsx(_components.li,{children:`Webhook notifications for delivery events`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`📋 Rate Limits:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Account-based email sending limits apply`}),`\n`]})]})}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":{"openapi":"post /send/email","title":"Send transactional email","description":"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking.\n\nThe API validates the request synchronously and returns **202 Accepted** when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response.\n\n**Optional headers:** `List-Unsubscribe` (passed through for list-unsubscribe), `X-SendPost-Mock-Email: true` (mock send, if supported).\n","href":"/api-reference/email-sending/send-transactional-email"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/sendx-31f00733/4aa6ed8c32d296da/swan.js"],"openApiReferenceData":{"operation":{"tags":["Email Sending"],"summary":"Send transactional email","description":"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking.\n\nThe API validates the request synchronously and returns **202 Accepted** when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response.\n\n**Optional headers:** `List-Unsubscribe` (passed through for list-unsubscribe), `X-SendPost-Mock-Email: true` (mock send, if supported).\n","operationId":"sendEmail","security":["2f61aa8a-9526-4f8a-b1de-a4562a1f45aa"],"requestBody":"dbcdfd0a-5bde-4711-a634-32aba1baf013","responses":{"202":"98edd8dd-c11f-40c6-ad69-05472c47fba5","400":"39c182d6-a982-41f8-8e22-727e3d0e6f6f","401":"2d428d36-f057-4a93-aeee-0279a37ec94a","422":"c62dece8-de3e-4c0e-a662-3c06b0858c0b","429":"f5c5a532-5a60-47da-9429-8421e14b0c52","500":"198ba1f9-f17e-4ea9-adb8-749387084d0a"},"method":"post","type":"path","servers":["52374e88-abde-42f5-97df-039cdd1dfe44"],"path":"/send/email","baseUrlOptions":["https://api.sendx.io/api/v1/rest"],"title":"Send transactional email","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from","to","subject","htmlBody"],"properties":{"from":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"from@example.com","isRequired":true,"uniqueKey":"from.email","typeLabel":"string\u003cemail>"},"name":{"type":"string","example":"From Name","uniqueKey":"from.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"from","typeLabel":"object"},"to":{"type":"array","items":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"to@example.com","isRequired":true,"uniqueKey":"to.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"type":"string","example":"To Name","uniqueKey":"to.items.[INDEX].name","typeLabel":"string"},"customFields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"to.items.[INDEX].customFields.additionalProperties","typeLabel":"string"},"uniqueKey":"to.items.[INDEX].customFields","typeLabel":"object"}},"uniqueKey":"to.items.[INDEX]","typeLabel":"object"},"minItems":1,"isRequired":true,"uniqueKey":"to","typeLabel":"object[]"},"subject":{"type":"string","example":"Your Subject Here","isRequired":true,"uniqueKey":"subject","typeLabel":"string"},"htmlBody":{"type":"string","example":"\u003ch1>Your HTML Content\u003c/h1>","isRequired":true,"uniqueKey":"htmlBody","typeLabel":"string"},"replyTo":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"reply@example.com","isRequired":true,"uniqueKey":"replyTo.email","typeLabel":"string\u003cemail>"},"name":{"type":"string","example":"Reply Name","uniqueKey":"replyTo.name","typeLabel":"string"}},"uniqueKey":"replyTo","typeLabel":"object"},"textBody":{"type":"string","example":"Your Text Content","uniqueKey":"textBody","typeLabel":"string"},"headers":{"type":"object","description":"Custom headers can be added to the email. These will be passed on when receving webhooks events for this email.","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{"X-Custom-Header":"Value"},"uniqueKey":"headers","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"from":{"email":"from@example.com","name":"From Name"},"to":[{"email":"to@example.com","name":"To Name","customFields":{}}],"subject":"Your Subject Here","htmlBody":"\u003ch1>Your HTML Content\u003c/h1>","textBody":"Your Text Content","headers":{"X-Custom-Header":"Value"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"98edd8dd-c11f-40c6-ad69-05472c47fba5":{"description":"✅ Email queued for delivery","content":{"application/json":{"schema":{"type":"object","description":"Success response when transactional email is queued for delivery (202 Accepted)","properties":{"status":{"type":"string","enum":["success"],"example":"success","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Email queued for delivery","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"example":{"status":"success","message":"Email queued for delivery"},"examples":{"Example":{"title":"Example","value":{"status":"success","message":"Email queued for delivery"}}},"exampleType":"examples"}},"exampleType":"examples"},"39c182d6-a982-41f8-8e22-727e3d0e6f6f":{"description":"❌ Bad Request - Validation failed (recipients, from, domain, add-on, invalid to)","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"example":"error","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request format","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"no_recipients":{"title":"no_recipients","value":{"status":"error","message":"no recipients specified"}},"from_required":{"title":"from_required","value":{"status":"error","message":"from email is required"}},"from_invalid_format":{"title":"from_invalid_format","value":{"status":"error","message":"from email must be a valid email address"}},"domain_not_whitelisted":{"title":"domain_not_whitelisted","value":{"status":"error","message":"From email not whitelisted. Please add and verify the domain first."}},"addon_not_active":{"title":"addon_not_active","value":{"status":"error","message":"Transactional email add-on is not active. Please activate it first at https://app.sendx.io/setting/addons."}},"invalid_recipient":{"title":"invalid_recipient","value":{"status":"error","message":"Invalid recipient email address: invalid email format"}}},"exampleType":"examples"}},"exampleType":"examples"},"2d428d36-f057-4a93-aeee-0279a37ec94a":{"description":"❌ Unauthorized - Missing or invalid team API key","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"example":"error","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request format","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"example":{"status":"error","message":"The Team ID or API Key specified is not valid"},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"The Team ID or API Key specified is not valid"}}},"exampleType":"examples"}},"exampleType":"examples"},"c62dece8-de3e-4c0e-a662-3c06b0858c0b":{"description":"❌ Unprocessable Entity - Invalid request body format","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"example":"error","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request format","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"example":{"status":"error","message":"invalid request body"},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"invalid request body"}}},"exampleType":"examples"}},"exampleType":"examples"},"f5c5a532-5a60-47da-9429-8421e14b0c52":{"description":"❌ Too Many Requests - Rate/limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"example":"error","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request format","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"account_limit":{"title":"account_limit","value":{"status":"error","message":"Account email sending limit exceeded. Please upgrade your plan."}},"contact_limit":{"title":"contact_limit","value":{"status":"error","message":"Contact limit exceeded. Current api has {N} contacts, but only {M} emails can be sent."}}},"exampleType":"examples"}},"exampleType":"examples"},"198ba1f9-f17e-4ea9-adb8-749387084d0a":{"description":"❌ Internal Server Error - System error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"example":"error","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","example":"Invalid request format","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"account_status":{"title":"account_status","value":{"status":"error","message":"error getting account email sending status"}},"queue_failed":{"title":"queue_failed","value":{"status":"error","message":"Failed to queue email for delivery"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"2f61aa8a-9526-4f8a-b1de-a4562a1f45aa":{"TeamApiKey":{"type":"apiKey","in":"header","name":"X-Team-ApiKey","description":"Team API key for authentication. Find your API key in SendX Settings → Team API Key.\n\n**Example:**\n```\nX-Team-ApiKey: your_team_api_key_here\n```\n","scopes":[],"schemeName":"TeamApiKey"}}},"servers":{"52374e88-abde-42f5-97df-039cdd1dfe44":{"url":"https://api.sendx.io/api/v1/rest","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Team-ApiKey","description":"Team API key for authentication. Find your API key in SendX Settings → Team API Key.\n\n**Example:**\n```\nX-Team-ApiKey: your_team_api_key_here\n```\n","scopes":[],"schemeName":"TeamApiKey"},"schema":{"title":"X-Team-ApiKey","type":"string","description":"Team API key for authentication. Find your API key in SendX Settings → Team API Key.\n\n**Example:**\n```\nX-Team-ApiKey: your_team_api_key_here\n```\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"TeamApiKey","name":"X-Team-ApiKey"}],"title":"TeamApiKey"}]},"originalFileLocation":"swagger.yaml"},"subdomain":"sendx-31f00733","siteName":"SendX Docs","title":"Send transactional email - SendX Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-20T12:53:37.848Z","originalFileLocation":"api-reference/email-sending/send-transactional-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=\"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking. The API validates the request synchronously and returns 202 Accepted when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response. Optional headers: List-Unsubscribe (passed through for list-unsubscribe), X-SendPost-Mock-Email: true (mock send, if supported).\">\u003cmeta data-mint-head name=\"application-name\" content=\"SendX Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_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=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send transactional email - SendX Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking. The API validates the request synchronously and returns 202 Accepted when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response. Optional headers: List-Unsubscribe (passed through for list-unsubscribe), X-SendPost-Mock-Email: true (mock send, if supported).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SendX Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sendx-31f00733.mintlify.site/_mintlify/api/og/v2?division=Email+Sending\u0026amp;title=Send+transactional+email\u0026amp;description=Sends+transactional+emails+to+specified+recipients+with+support+for+personalization%2C+attachments%2C+and+tracking.%0A%0AThe+API+validates+the+request+synchronously+and\u0026amp;theme=b6112f43a4edf818fc3f51ae\u0026amp;signature=c731cf04cb43828d0a2e294e7c2ddf4c2037d6ebc0fb654b6dee54386fdfe001\">\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 transactional email - SendX Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking. The API validates the request synchronously and returns 202 Accepted when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response. Optional headers: List-Unsubscribe (passed through for list-unsubscribe), X-SendPost-Mock-Email: true (mock send, if supported).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sendx-31f00733.mintlify.site/_mintlify/api/og/v2?division=Email+Sending\u0026amp;title=Send+transactional+email\u0026amp;description=Sends+transactional+emails+to+specified+recipients+with+support+for+personalization%2C+attachments%2C+and+tracking.%0A%0AThe+API+validates+the+request+synchronously+and\u0026amp;theme=b6112f43a4edf818fc3f51ae\u0026amp;signature=c731cf04cb43828d0a2e294e7c2ddf4c2037d6ebc0fb654b6dee54386fdfe001\">\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=\"/mintlify-assets/_mintlify/favicons/sendx-31f00733/oFBACZyJ7SbOXIH3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SendX Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ffd700\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/email-sending/send-transactional-email.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sendx.io/#organization\",\"name\":\"SendX Docs\",\"url\":\"https://docs.sendx.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendx-31f00733/3nIKI_xln-0gUAbn/logo/light.svg?fit=max\u0026auto=format\u0026n=3nIKI_xln-0gUAbn\u0026q=85\u0026s=5ce863c22b88897598d8f817e4420c6d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sendx.io#website\",\"name\":\"SendX Docs\",\"url\":\"https://docs.sendx.io\",\"publisher\":{\"@id\":\"https://docs.sendx.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email#webpage\",\"url\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email\",\"name\":\"Send transactional email\",\"description\":\"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking. The API validates the request synchronously and returns 202 Accepted when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response. Optional headers: List-Unsubscribe (passed through for list-unsubscribe), X-SendPost-Mock-Email: true (mock send, if supported).\",\"dateModified\":\"2026-02-20T12:53:37.848Z\",\"isPartOf\":{\"@id\":\"https://docs.sendx.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SendX Docs\",\"item\":\"https://docs.sendx.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Send transactional email\",\"item\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email#apireference\",\"headline\":\"Send transactional email\",\"name\":\"Send transactional email\",\"description\":\"Sends transactional emails to specified recipients with support for personalization, attachments, and tracking. The API validates the request synchronously and returns 202 Accepted when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response. Optional headers: List-Unsubscribe (passed through for list-unsubscribe), X-SendPost-Mock-Email: true (mock send, if supported).\",\"url\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sendx.io/api-reference/email-sending/send-transactional-email#webpage\"},\"dateModified\":\"2026-02-20T12:53:37.848Z\",\"publisher\":{\"@id\":\"https://docs.sendx.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sendx.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SendX Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SendX Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Welcome","pages":[{"title":"Welcome","href":""}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Schemas","href":"/api-reference/schema"}]},{"group":"Getting Started","pages":[{"openapi":"post /contact/identify","title":"Identify contact","href":"/api-reference/getting-started/identify-contact"},{"openapi":"post /contact/identify/bulk","title":"Identify Bulk Contacts","href":"/api-reference/getting-started/identify-contact-bulk"},{"openapi":"post /contact/track","title":"Track contact","description":"Legacy endpoint for tracking contact behavior through tags.\n\n\n**🎯 Key Features:**\n- Add or remove tags\n- Trigger automations\n- Track user behavior\n","href":"/api-reference/getting-started/add-tracking-info"}]},{"group":"Email Sending","pages":[{"openapi":"post /send/email","title":"Send transactional email","href":"/api-reference/email-sending/send-transactional-email"},{"openapi":"post /send/template","title":"Send email using template","description":"Sends emails using a pre-defined template with variable substitution. Per-recipient personalization runs in the worker and is not validated in the API.\n\nThe API validates the request synchronously and returns **202 Accepted** when the email is queued. Actual sending and personalization happen asynchronously in a worker. A 202 does not guarantee delivery; it means the request was accepted and queued. Per-recipient success/failure is not returned in the API response.\n\n**Optional headers:** `List-Unsubscribe` (passed through for list-unsubscribe), `X-SendPost-Mock-Email: true` (mock send, if supported).\n","href":"/api-reference/email-sending/send-email-using-template"},{"title":"Personalization \u0026 Merge Tags","sidebarTitle":"Personalization","href":"/api-reference/email-sending/personalization"}]},{"group":"Contact","pages":[{"openapi":"get /contact","title":"Get all contacts","href":"/api-reference/contact/get-all-contacts"},{"openapi":"post /contact","title":"Create a new contact","href":"/api-reference/contact/create-a-new-contact"},{"openapi":"get /contact/{identifier}","title":"Get contact by ID","href":"/api-reference/contact/get-contact-by-id"},{"openapi":"put /contact/{identifier}","title":"Update contact","href":"/api-reference/contact/update-contact"},{"openapi":"delete /contact/{identifier}","title":"Delete contact","href":"/api-reference/contact/delete-contact"},{"openapi":"post /contact/unsubscribe/{identifier}","title":"Unsubscribe contact","href":"/api-reference/contact/unsubscribe-contact"}]},{"group":"Events","pages":[{"openapi":"post /events/revenue","title":"Push revenue event","href":"/api-reference/events/track-revenue-event"},{"openapi":"post /events/custom","title":"Push custom event","href":"/api-reference/events/track-custom-event"}]},{"group":"Campaign","pages":[{"openapi":"get /campaign","title":"Get all campaigns","href":"/api-reference/campaign/get-all-campaigns"},{"openapi":"post /campaign","title":"Create campaign","href":"/api-reference/campaign/create-campaign"},{"openapi":"get /campaign/{identifier}","title":"Get campaign by ID","href":"/api-reference/campaign/get-campaign-by-id"},{"openapi":"delete /campaign/{identifier}","title":"Delete campaign","href":"/api-reference/campaign/delete-campaign"}]},{"group":"List","pages":[{"openapi":"get /list","title":"Get all lists","href":"/api-reference/list/get-all-lists"},{"openapi":"post /list","title":"Create list","href":"/api-reference/list/create-list"},{"openapi":"get /list/{identifier}","title":"Get list by ID","href":"/api-reference/list/get-list-by-id"},{"openapi":"put /list/{identifier}","title":"Update list","href":"/api-reference/list/update-list"},{"openapi":"delete /list/{identifier}","title":"Delete list","href":"/api-reference/list/delete-list"}]},{"group":"Tag","pages":[{"openapi":"get /tag","title":"Get all tags","href":"/api-reference/tag/get-all-tags"},{"openapi":"post /tag","title":"Create tag","href":"/api-reference/tag/create-tag"},{"openapi":"get /tag/{identifier}","title":"Get tag by ID","href":"/api-reference/tag/get-tag-by-id"},{"openapi":"put /tag/{identifier}","title":"Update tag","href":"/api-reference/tag/update-tag"},{"openapi":"delete /tag/{identifier}","title":"Delete tag","href":"/api-reference/tag/delete-tag"}]},{"group":"Segment","pages":[{"openapi":"get /segment","title":"Get all segments","href":"/api-reference/segment/get-all-segments"},{"openapi":"get /segment/{identifier}","title":"Get segment by ID","href":"/api-reference/segment/get-segment-by-id"}]},{"group":"Sender","pages":[{"openapi":"get /sender","title":"Get all senders","href":"/api-reference/sender/get-all-senders"},{"openapi":"post /sender","title":"Create sender","href":"/api-reference/sender/create-sender"}]},{"group":"Template","pages":[{"openapi":"get /template/email","title":"Get all templates","href":"/api-reference/template/get-all-templates"},{"openapi":"post /template/email","title":"Create email template","href":"/api-reference/template/create-email-template"},{"openapi":"get /template/email/{identifier}","title":"Get template by ID","href":"/api-reference/template/get-template-by-id"},{"openapi":"put /template/email/{identifier}","title":"Update template","href":"/api-reference/template/update-template"},{"openapi":"delete /template/email/{identifier}","title":"Delete template","href":"/api-reference/template/delete-template"}]},{"group":"Custom Field","pages":[{"openapi":"get /customfield","title":"Get all custom fields","href":"/api-reference/custom-field/get-all-custom-fields"},{"openapi":"post /customfield","title":"Create custom field","href":"/api-reference/custom-field/create-custom-field"},{"openapi":"get /customfield/{identifier}","title":"Get custom field by ID","href":"/api-reference/custom-field/get-custom-field-by-id"},{"openapi":"put /customfield/{identifier}","title":"Update custom field","href":"/api-reference/custom-field/update-custom-field"},{"openapi":"delete /customfield/{identifier}","title":"Delete custom field","href":"/api-reference/custom-field/delete-custom-field"}]},{"group":"Domain","pages":[{"openapi":"get /domain","title":"Get all domains","href":"/api-reference/domain/get-all-domains"},{"openapi":"post /domain","title":"Create domain","href":"/api-reference/domain/create-domain"},{"openapi":"get /domain/{identifier}","title":"Get domain by ID","href":"/api-reference/domain/get-domain-by-id"},{"openapi":"delete /domain/{identifier}","title":"Delete domain","href":"/api-reference/domain/delete-domain"}]},{"group":"Webhook","pages":[{"openapi":"get /webhook","title":"Get all webhooks","href":"/api-reference/webhook/get-all-webhooks"},{"openapi":"post /webhook","title":"Create webhook","href":"/api-reference/webhook/create-webhook"},{"openapi":"get /webhook/{identifier}","title":"Get webhook by ID","href":"/api-reference/webhook/get-webhook-by-id"},{"openapi":"put /webhook/{identifier}","title":"Update webhook","href":"/api-reference/webhook/update-webhook"},{"openapi":"delete /webhook/{identifier}","title":"Delete webhook","href":"/api-reference/webhook/delete-webhook"},{"title":"SendX Webhook Object","openapi":"webhook SendXWebhooks","href":"/api-reference/webhook/sendx-webhook-object"},{"title":"Verifying SendX Webhook","href":"/api-reference/webhook/verify-webhook"}]},{"group":"Report","pages":[{"openapi":"get /report/campaign/{identifier}","title":"Get campaign report","href":"/api-reference/report/get-campaign-report"}]},{"group":"Post","pages":[{"openapi":"get /post","title":"Get all posts","href":"/api-reference/post/get-all-posts"},{"openapi":"post /post","title":"Create blog post","href":"/api-reference/post/create-blog-post"},{"openapi":"get /post/{identifier}","title":"Get post by ID","href":"/api-reference/post/get-post-by-id"},{"openapi":"put /post/{identifier}","title":"Update post","href":"/api-reference/post/update-post"},{"openapi":"delete /post/{identifier}","title":"Delete post","href":"/api-reference/post/delete-post"}]},{"group":"Post Category","pages":[{"openapi":"get /post/category","title":"Get all post categories","href":"/api-reference/post-category/get-all-post-categories"},{"openapi":"post /post/category","title":"Create post category","href":"/api-reference/post-category/create-post-category"},{"openapi":"get /post/category/{identifier}","title":"Get post category by ID","href":"/api-reference/post-category/get-post-category-by-id"},{"openapi":"put /post/category/{identifier}","title":"Update post category","href":"/api-reference/post-category/update-post-category"},{"openapi":"delete /post/category/{identifier}","title":"Delete post category","href":"/api-reference/post-category/delete-post-category"}]},{"group":"Post Tag","pages":[{"openapi":"get /post/tag","title":"Get all post tags","href":"/api-reference/post-tag/get-all-post-tags"},{"openapi":"post /post/tag","title":"Create post tag","href":"/api-reference/post-tag/create-post-tag"},{"openapi":"get /post/tag/{identifier}","title":"Get post tag by ID","href":"/api-reference/post-tag/get-post-tag-by-id"},{"openapi":"put /post/tag/{identifier}","title":"Update post tag","href":"/api-reference/post-tag/update-post-tag"},{"openapi":"delete /post/tag/{identifier}","title":"Delete post tag","href":"/api-reference/post-tag/delete-post-tag"}]},{"group":"Team Member","pages":[{"openapi":"get /team/member/{identifier}","title":"Get a team member by ID","href":"/api-reference/team-member/get-team-member"},{"openapi":"get /team/member","title":"Get all team members","href":"/api-reference/team-member/get-all-team-member"}]}]}]},"basePath":"","title":"Send transactional email - SendX Docs","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}