Send an HTML email to one or multiple recipients. Delivery is asynchronous: a successful request returns 202 Accepted with a batchId, and the emails are processed in the background.Maximum 500 recipients per API call. Unsubscribed recipients are filtered out automatically before sending and do not count toward your sending limit.
202 Accepted: Processing started. Returns status: "IN PROGRESS", message, batchId, and a limits object.
400 Bad Request: Invalid request parameters or malformed JSON
401 Unauthorized: Authentication required or invalid API key
500 Internal Server Error: Unexpected server error
The response limits object shows your sending-quota usage for this request (limit, used, remaining, requested). requested reflects the recipient count after unsubscribed addresses are filtered out.
Authenticate with your API key in the Authorization header. The key must have the emailSend scope.
Email configuration and recipients. Maximum 500 recipients per API call. Unsubscribed recipients are filtered out automatically and do not count toward your sending limit.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sendr API","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/sendr/SIXITsqKtYsLiM8w/logo/light.svg?fit=max\u0026auto=format\u0026n=SIXITsqKtYsLiM8w\u0026q=85\u0026s=ff4b94e7cadb4dd47d3090534e74bb10","dark":"https://mintcdn.com/sendr/SIXITsqKtYsLiM8w/logo/dark.svg?fit=max\u0026auto=format\u0026n=SIXITsqKtYsLiM8w\u0026q=85\u0026s=3d825c56fd579134a802f1415bd8a94b"},"favicon":"https://mintcdn.com/sendr/zfEySIPogVmPBhNV/favicon.svg?fit=max\u0026auto=format\u0026n=zfEySIPogVmPBhNV\u0026q=85\u0026s=aded752117d6b09cd22ca51c2c539e1e","navbar":{"links":[{"href":"mailto:support@sendr.app","label":"Support"}]},"footer":{"socials":{"website":"https://platform.sendr.app"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendr","hasAudioNarration":false,"actualSubdomain":"sendr","customDomains":["docs.sendr.app"],"gitSource":{"type":"github","owner":"maratgaliev","repo":"mailerdocs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a4335d1e908ecd355fb1aa3","collectionId":"842fc841-c264-41de-bd48-97746aa33441","schemaVersion":"v3"},"entitlements":{},"buildId":"6ae9270cce2e4391f29e2535:success","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Domain API","count":2},{"language":"default","tag":"Email API","count":1},{"language":"default","tag":"Documentation","count":1},{"language":"default","tag":"Stats API","count":1},{"language":"default","tag":"Logs API","count":1}]},"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/email/send","slug":"/api-reference/email/send","pageMetadata":{"title":"Sending Email","openapi":"POST /email","description":"Send an email to one or multiple recipients","href":"/api-reference/email/send"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Send an email to one or multiple recipients\"\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={code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Send an HTML email to one or multiple recipients. Delivery is asynchronous: a successful request returns `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`202 Accepted`})}),` with a `,_jsx(_components.code,{children:`batchId`}),`, and the emails are processed in the background.`]}),`\n`,_jsxs(_components.p,{children:[`Maximum `,_jsx(_components.strong,{children:`500 recipients`}),` per API call. Unsubscribed recipients are filtered out automatically before sending and do not count toward your sending limit.`]}),`\n`,_jsx(Heading,{level:`3`,id:`request`,children:`Request`}),`\n`,_jsx(_components.p,{children:`The body has two parts:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`recipients`}),` — array of `,_jsx(_components.code,{children:`{ email, name? }`}),` (1–500 items, `,_jsx(_components.code,{children:`email`}),` required).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`emailConfig`}),` — message configuration.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Required `,_jsx(_components.code,{children:`emailConfig`}),` fields:`]}),` `,_jsx(_components.code,{children:`subject`}),`, `,_jsx(_components.code,{children:`from`}),`, `,_jsx(_components.code,{children:`body`}),` (HTML).`]}),`\n`,_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Optional `,_jsx(_components.code,{children:`emailConfig`}),` fields:`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fromName`})}),_jsx(_components.td,{children:`Sender display name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`companyName`})}),_jsx(_components.td,{children:`Per-send override; falls back to your tenant’s saved company name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`companyAddress`})}),_jsx(_components.td,{children:`Per-send override; falls back to your tenant’s saved mailing address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`companyWebsite`})}),_jsx(_components.td,{children:`Per-send override (valid URL); falls back to your tenant’s saved website`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`returnPath`})}),_jsx(_components.td,{children:`Return-Path / bounce address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsubscribeUrl`})}),_jsxs(_components.td,{children:[`May contain the `,_jsx(_components.code,{children:`{{email}}`}),` placeholder, replaced with the recipient’s address`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trackOpens`})}),_jsxs(_components.td,{children:[`Defaults to `,_jsx(_components.code,{children:`true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trackClicks`})}),_jsxs(_components.td,{children:[`Defaults to `,_jsx(_components.code,{children:`true`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`202 Accepted`}),`: Processing started. Returns `,_jsx(_components.code,{children:`status: \"IN PROGRESS\"`}),`, `,_jsx(_components.code,{children:`message`}),`, `,_jsx(_components.code,{children:`batchId`}),`, and a `,_jsx(_components.code,{children:`limits`}),` object.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400 Bad Request`}),`: Invalid request parameters or malformed JSON`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),`: Authentication required or invalid API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),`: Unexpected server error`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The response `,_jsx(_components.code,{children:`limits`}),` object shows your sending-quota usage for this request (`,_jsx(_components.code,{children:`limit`}),`, `,_jsx(_components.code,{children:`used`}),`, `,_jsx(_components.code,{children:`remaining`}),`, `,_jsx(_components.code,{children:`requested`}),`). `,_jsx(_components.code,{children:`requested`}),` reflects the recipient count `,_jsx(_components.strong,{children:`after`}),` unsubscribed addresses are filtered out.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Authenticate with your API key in the `,_jsx(_components.code,{children:`Authorization`}),` header. The key must have the `,_jsx(_components.code,{children:`emailSend`}),` scope.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Sending Email","openapi":"POST /email","description":"Send an email to one or multiple recipients","href":"/api-reference/email/send"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Send Email","description":"Send an email to one or multiple recipients","servers":["73dfc2f5-3314-4f11-9bf9-173d698ed579","e52c1d59-0542-44a8-8516-01c7e560823f"],"requestBody":"2764737f-8d63-475b-bc29-65544c287966","responses":{"202":"7b1ba871-7fb1-4a9f-96dc-ba4aea55aaab","400":"920f6545-444d-411f-ba0f-f5ca521d18ed","401":"dd060ce0-b43f-41d4-ab94-8112e09c88b8","500":"fc212be6-e40b-40f6-8e7d-a6096974b453"},"method":"post","type":"path","security":["6d14711b-93eb-4fa5-86a6-515114799050"],"path":"/email","baseUrlOptions":["https://sending.sendrapp.org","http://localhost:3001"],"title":"Send Email","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Email configuration and recipients. Maximum 500 recipients per API call. Unsubscribed recipients are filtered out automatically and do not count toward your sending limit.","required":true,"content":{"application/json":{"schema":{"type":"object","required":["recipients","emailConfig"],"properties":{"recipients":{"type":"array","description":"List of email recipients. Maximum 500 per call.","items":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","description":"Recipient email address","isRequired":true,"uniqueKey":"recipients.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"type":"string","description":"Recipient name (optional)","uniqueKey":"recipients.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"recipients.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"recipients","typeLabel":"object[]"},"emailConfig":{"type":"object","required":["subject","from","body"],"properties":{"subject":{"type":"string","description":"Email subject (required)","isRequired":true,"uniqueKey":"emailConfig.subject","typeLabel":"string"},"from":{"type":"string","description":"Sender email address (required)","isRequired":true,"uniqueKey":"emailConfig.from","typeLabel":"string"},"body":{"type":"string","description":"HTML email content (required)","isRequired":true,"uniqueKey":"emailConfig.body","typeLabel":"string"},"fromName":{"type":"string","description":"Sender display name (optional)","uniqueKey":"emailConfig.fromName","typeLabel":"string"},"companyName":{"type":"string","maxLength":255,"description":"Optional per-send override of the company name. Falls back to your tenant's saved companyName.","uniqueKey":"emailConfig.companyName","typeLabel":"string"},"companyAddress":{"type":"string","maxLength":500,"description":"Optional per-send override of the company mailing address. Falls back to your tenant's saved companyMailingAddress.","uniqueKey":"emailConfig.companyAddress","typeLabel":"string"},"companyWebsite":{"type":"string","format":"uri","description":"Optional per-send override of the company website URL. Falls back to your tenant's saved companyWebsite.","uniqueKey":"emailConfig.companyWebsite","typeLabel":"string\u003curi>"},"returnPath":{"type":"string","format":"email","description":"Optional Return-Path (bounce) address.","uniqueKey":"emailConfig.returnPath","typeLabel":"string\u003cemail>"},"unsubscribeUrl":{"type":"string","description":"Optional unsubscribe URL. May contain the {{email}} placeholder, which is substituted with the recipient's address.","uniqueKey":"emailConfig.unsubscribeUrl","typeLabel":"string"},"trackOpens":{"type":"boolean","default":true,"description":"Whether to track opens. Defaults to true.","uniqueKey":"emailConfig.trackOpens","typeLabel":"boolean"},"trackClicks":{"type":"boolean","default":true,"description":"Whether to track link clicks. Defaults to true.","uniqueKey":"emailConfig.trackClicks","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"emailConfig","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"recipients":[{"email":"jsmith@example.com","name":"\u003cstring>"}],"emailConfig":{"subject":"\u003cstring>","from":"\u003cstring>","body":"\u003cstring>","fromName":"\u003cstring>","companyName":"\u003cstring>","companyAddress":"\u003cstring>","companyWebsite":"\u003cstring>","returnPath":"jsmith@example.com","unsubscribeUrl":"\u003cstring>","trackOpens":true,"trackClicks":true}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7b1ba871-7fb1-4a9f-96dc-ba4aea55aaab":{"description":"Accepted — email processing has started. Delivery happens asynchronously.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["IN PROGRESS"],"description":"Processing status","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Status message, e.g. \"Email processing started\"","uniqueKey":"message","typeLabel":"string"},"batchId":{"type":"string","description":"Identifier for this send batch (e.g. batch_1782700000000_ab12cd34)","uniqueKey":"batchId","typeLabel":"string"},"limits":{"type":"object","description":"Your sending-limit usage for this request","properties":{"limit":{"type":"integer","description":"Total quota for the current period","uniqueKey":"limits.limit","typeLabel":"integer"},"used":{"type":"integer","description":"Quota already used","uniqueKey":"limits.used","typeLabel":"integer"},"remaining":{"type":"integer","description":"Remaining quota","uniqueKey":"limits.remaining","typeLabel":"integer"},"requested":{"type":"integer","description":"Recipients requested in this call (after unsubscribe filtering)","uniqueKey":"limits.requested","typeLabel":"integer"}},"uniqueKey":"limits","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"IN PROGRESS","message":"\u003cstring>","batchId":"\u003cstring>","limits":{"limit":123,"used":123,"remaining":123,"requested":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"920f6545-444d-411f-ba0f-f5ca521d18ed":{"description":"Invalid request parameters (validation error) or malformed JSON","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"integer","format":"int32","description":"Error code","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"dd060ce0-b43f-41d4-ab94-8112e09c88b8":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"integer","format":"int32","description":"Error code","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fc212be6-e40b-40f6-8e7d-a6096974b453":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"integer","format":"int32","description":"Error code","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6d14711b-93eb-4fa5-86a6-515114799050":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","scopes":[]}}},"servers":{"73dfc2f5-3314-4f11-9bf9-173d698ed579":{"url":"https://sending.sendrapp.org","description":"Email Sending API"},"e52c1d59-0542-44a8-8516-01c7e560823f":{"url":"http://localhost:3001","description":"Local Development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","scopes":[]},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"Authorization"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"sendr","siteName":"Sendr API","title":"Sending Email - Sendr API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-29T20:58:23.620Z","originalFileLocation":"api-reference/email/send.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=\"Send an email to one or multiple recipients\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sendr API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_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/sendr/vAdeJH38kwwAhFn5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Sending Email - Sendr API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send an email to one or multiple recipients\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sendr API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sendr.app/api-reference/email/send\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sendr.mintlify.app/_mintlify/api/og/v2?division=Email+API\u0026amp;title=Sending+Email\u0026amp;description=Send+an+email+to+one+or+multiple+recipients\u0026amp;theme=89a8853c50c94b3d703fb67e\u0026amp;signature=b1ecb26b8a41c13d34c2459d76a5308bd73951cb7e93360150dd84078fd4e80b\">\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=\"Sending Email - Sendr API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send an email to one or multiple recipients\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sendr.mintlify.app/_mintlify/api/og/v2?division=Email+API\u0026amp;title=Sending+Email\u0026amp;description=Send+an+email+to+one+or+multiple+recipients\u0026amp;theme=89a8853c50c94b3d703fb67e\u0026amp;signature=b1ecb26b8a41c13d34c2459d76a5308bd73951cb7e93360150dd84078fd4e80b\">\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/sendr/vAdeJH38kwwAhFn5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sendr API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sendr.app/api-reference/email/send\">\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/send.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sendr.app/#organization\",\"name\":\"Sendr API\",\"url\":\"https://docs.sendr.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendr/SIXITsqKtYsLiM8w/logo/light.svg?fit=max\u0026auto=format\u0026n=SIXITsqKtYsLiM8w\u0026q=85\u0026s=ff4b94e7cadb4dd47d3090534e74bb10\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sendr.app#website\",\"name\":\"Sendr API\",\"url\":\"https://docs.sendr.app\",\"publisher\":{\"@id\":\"https://docs.sendr.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sendr.app/api-reference/email/send#webpage\",\"url\":\"https://docs.sendr.app/api-reference/email/send\",\"name\":\"Sending Email\",\"description\":\"Send an email to one or multiple recipients\",\"dateModified\":\"2026-06-29T20:58:23.620Z\",\"isPartOf\":{\"@id\":\"https://docs.sendr.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sendr.app/api-reference/email/send#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sendr.app/api-reference/email/send#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sendr API\",\"item\":\"https://docs.sendr.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sending Email\",\"item\":\"https://docs.sendr.app/api-reference/email/send\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sendr.app/api-reference/email/send#apireference\",\"headline\":\"Sending Email\",\"name\":\"Sending Email\",\"description\":\"Send an email to one or multiple recipients\",\"url\":\"https://docs.sendr.app/api-reference/email/send\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sendr.app/api-reference/email/send#webpage\"},\"dateModified\":\"2026-06-29T20:58:23.620Z\",\"publisher\":{\"@id\":\"https://docs.sendr.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sendr.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sendr API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sendr API","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Documentation","pages":[{"title":"Introduction","description":"Email Service API Documentation","href":"/api-reference/introduction"}]},{"group":"Email API","pages":[{"title":"Sending Email","openapi":"POST /email","href":"/api-reference/email/send"}]},{"group":"Domain API","pages":[{"title":"Domain verification","openapi":"POST /v2/domain/{id}/verify","description":"Verify a domain's DNS settings","href":"/api-reference/domain/verify"},{"title":"Domain information","openapi":"GET /v2/domain","href":"/api-reference/domain/list"}]},{"group":"Stats API","pages":[{"title":"Get Tenant Statistics","openapi":"GET /domain/stats","href":"/api-reference/stats/get"}]},{"group":"Logs API","pages":[{"title":"Get Email Logs","openapi":"GET /webhooks/{domain}","href":"/api-reference/webhooks/get"}]}]}]},"basePath":"","title":"Sending Email - Sendr API","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}