Use this endpoint when you want to send a transactional email without
creating a template in the dashboard. You provide the rendered HTML
yourself and Minimo handles dispatch, delivery, and tracking.Typical use cases:
Server-side rendered receipts: invoices, order confirmations, shipping notifications
Internal notifications: alerts produced by your own background jobs
Anything dynamic enough to not fit a pre-defined template
Tracking (open pixel + click rewriting) is injected server-side. Send your raw HTML as-is: don’t pre-rewrite
links or append a pixel yourself. Click rewriting follows your Settings → Tracking → Email switch (on by default).
Before You Start
Create an API key with the Transactional permission in Developer → API keys.
Nothing else to set up: Minimo sends the email. Until you verify a sending domain, it goes out from a shared Minimo
address with your workspace’s name; to send from your own domain see
Senders and domains.
Have your HTML body ready. Minimo does not render templates for this endpoint.
Sending for one of your customers
If your app sends email for its own customers (for example restaurants), add tenant with your id for that customer.
Once your widget settings are saved, the recipient becomes that customer’s guest, and
the email counts in that customer’s history and statistics and in GET /public/v1/messages/list?tenant=…. Minimo does
not check marketing consent on this endpoint: use it for service emails (confirmations, reminders). See
Start here for the other ways to send.To send guests’ replies to your customer, add replyTo, for example
"replyTo": "Trattoria da Mario <trattoriadamario@gmail.com>". Any mailbox works, also one outside your verified domains.To show the customer’s name as the sender, add fromName, for example "fromName": "Trattoria da Mario". It works
before you verify a domain too. Without it, guests see your workspace’s name.
What the Server Does to Your HTML
When you send html, the backend:
Resolves placeholders: {{UNSUBSCRIBE_URL}}, {{PREFERENCES_URL}}, and {{FAKE_IMAGE_URL}} are replaced with the per-recipient tracked URLs.
Strips any pre-existing tracking pixel: an <img> whose src matches the Minimo open-pixel pattern is removed so it can’t double-fire.
Rewrites tracked anchors: every <a href> pointing to http(s) or a relative URL is replaced with a click-tracking URL. mailto:, fragment-only (#…), and pre-existing /api/click/* links are left alone. This step runs only while click tracking is on in Settings → Tracking → Email (the default); when you turn it off, links go out exactly as you wrote them, while the placeholders above and the open pixel still apply.
Appends the open-tracking pixel at the end of <body> (or at the document root if no <body> exists).
The recipient receives the final HTML; analytics flow into GET /public/v1/emails/{id}/stats.
A request that passes validation answers HTTP 201, also when the provider then rejects the message: read status
(sent or failed) to know what happened.
When the provider rejects the message you still get back the same id, so the delivery row remains queryable:
{ "data": { "id": "DMPNEF8", "status": "failed", "failureReason": "Email address is not verified.", "statsUrl": "/public/v1/emails/DMPNEF8/stats" }}
Use Cases
Order receipt with embedded link
Render the receipt server-side and post it raw: Minimo rewrites the View receipt anchor into a tracked link.
{ "to": "customer@example.com", "subject": "Receipt for ORD-12345", "html": "<h1>Thanks, Jane!</h1><p>Your order <strong>ORD-12345</strong> is on the way.</p><p><a href=\"https://shop.example.com/orders/ORD-12345\">Track your order</a></p>"}
Magic-link sign-in
Override the sender per request to brand the email for a specific product surface.
{ "to": "newuser@example.com", "subject": "Sign in to Acme", "html": "<p>Hi! Click <a href=\"https://app.example.com/auth?token=eyJ...\">here</a> to sign in. Link expires in 15 minutes.</p>", "fromAddress": "no-reply@acme.com", "fromName": "Acme Sign-In"}
Internal alert from a background job
Plain HTML with a single CTA is enough: the open and click events surface in the stats endpoint.
{ "to": "ops@example.com", "subject": "[ALERT] Queue depth above threshold", "html": "<p>Worker queue at 12,400 jobs.</p><p><a href=\"https://admin.example.com/jobs\">Open dashboard</a></p>", "text": "Worker queue at 12,400 jobs. Open dashboard: https://admin.example.com/jobs"}
Best Practices
Pair every send with a statsUrl lookup
The response includes statsUrl. Persist the id (or the full statsUrl) alongside whatever business object triggered the send (order id, user id, etc.) so you can correlate opens and clicks later.
Handle the failed branch
status: "failed" means the provider rejected the message, usually a malformed recipient, an unverified sender, or a hard bounce. Surface failureReason to your operators, then either retry with corrected data or log the failure.
Keep HTML self-contained
Inline your CSS. Many email clients drop <style> blocks. Test in major clients (Gmail, Apple Mail, Outlook) before going live.
Provide a text fallback for deliverability
Spam filters reward multipart messages. Adding a plain-text alternative reduces the chance of landing in the junk folder.
Don’t double-track
If your HTML already contains /api/click/* URLs or an open pixel from a previous Minimo send, leave them alone: the server detects and skips them. Inserting your own tracking on top is unnecessary.
Common Errors
Errors use the standard error body{ "status": "FAIL", "message": "<CODE>", "userMessage": "…" }.
Answer
Cause
400 INVALID_PARAMETERS
A required field is missing or invalid (for example to is not an email).
401 INVALID_TOKEN
Wrong key, or the key does not have the Transactional permission.
402 QUOTA_EXCEEDED
100 emails today and no credit top-up yet.
422 SENDER_NOT_ALLOWED and other SENDER_* codes
The sender is not under a verified domain of your workspace. See Errors and limits.
422 INVALID_REPLY_TO
replyTo is not a valid email address. Nothing is sent.
201 with "status": "failed"
The provider rejected the message; see failureReason.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
to
string<email>
required
Recipient email address.
subject
string
required
Email subject line.
html
string
required
Pre-rendered HTML body. The server injects the open
pixel and rewrites anchor hrefs — do not pre-process
them on your side.
text
string
Plain-text fallback for clients without HTML support.
fromAddress
string<email>
Sender address for this send. Must be under a VERIFIED sending
domain of your workspace, otherwise 422 (never a silent
fallback). Omit every sender field to use the workspace default.
At most one of senderId, from, fromAddress.
from
string
Same as fromAddress, also accepting "Name <address@domain>".
Example:
"Trattoria Da Mario <prenotazioni@trattoriadamario.it>"
senderId
integer
Id of a sender from GET /public/v1/domains/{id}/senders. Its
domain must be verified, otherwise 422.
Example:
34
fromName
string
Per-request sender display name override.
tenant
string
Your own reference for the customer this send belongs to.
Stored on the message; filter with
GET /public/v1/messages/list?tenant=.
Maximum string length: 64
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
Example:
"restaurant-4812"
replyTo
string
Where replies go. "Name
" or a bare address. Any
mailbox works, also one outside your verified domains (for
example the restaurant's own Gmail). Omit it to keep your
workspace default. A malformed value answers
422 INVALID_REPLY_TO and nothing is sent.
Maximum string length: 320
Example:
"Trattoria da Mario <trattoriadamario@gmail.com>"
Response
Delivery accepted by the queue. Check data.status to tell
whether the provider actually accepted the message.
data
object
Show child attributes
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Minimo Docs","colors":{"primary":"#000000","light":"#fafafa","dark":"#000000"},"favicon":"https://mintcdn.com/minimo/3CkweOTs_wJBldaS/favicon.svg?fit=max\u0026auto=format\u0026n=3CkweOTs_wJBldaS\u0026q=85\u0026s=741f59ded2f05d51dd8ed745b6b9304d","logo":{"light":"https://mintcdn.com/minimo/_5TQWO7ZAmNbow_0/logo/light.svg?fit=max\u0026auto=format\u0026n=_5TQWO7ZAmNbow_0\u0026q=85\u0026s=770ea7f424284ce6f88684bb97af23f0","dark":"https://mintcdn.com/minimo/_5TQWO7ZAmNbow_0/logo/dark.svg?fit=max\u0026auto=format\u0026n=_5TQWO7ZAmNbow_0\u0026q=85\u0026s=d0eaf24238816ed860e88d67985c7d27"},"api":{"openapi":["api-reference/openApi.yml"]},"navbar":{"links":[{"label":"Support","href":"mailto:info@minimo.it"}],"primary":{"type":"button","label":"Start now for free","href":"https://app.minimo.it"}},"footer":{"socials":{"instagram":"https://instagram.com/thebareminimo","linkedin":"https://www.linkedin.com/company/thebareminimo"}},"integrations":{},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Sito Web","href":"https://minimo.it","icon":"desktop"},{"anchor":"Blog","href":"https://minimo.it/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"minimo","hasAudioNarration":false,"actualSubdomain":"minimo","customDomains":["docs.minimo.it"],"gitSource":{"type":"github","owner":"thebareminimo","repo":"docs-v2","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af9f3ab474f4586a49a888e","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":81},{"language":"default","tag":"Embedded for SaaS","count":44},{"language":"default","tag":"Product","count":22},{"language":"default","tag":"Embedded API","count":21},{"language":"default","tag":"Messaging Channels","count":15},{"language":"default","tag":"Connect a Bot (WhatsApp)","count":14},{"language":"default","tag":"Widgets","count":13},{"language":"default","tag":"Domains","count":12},{"language":"default","tag":"Inbox","count":11},{"language":"default","tag":"Email","count":11}]},"assistantConfig":{},"basePath":"","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/messaging-channels/email/send-html","slug":"/api-reference/messaging-channels/email/send-html","pageMetadata":{"title":"Send One-Shot HTML Email","description":"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required","openapi":"post /public/v1/emails","href":"/api-reference/messaging-channels/email/send-html"},"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: \"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required\"\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={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Table,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Use this endpoint when you want to send a transactional email `,_jsx(_components.strong,{children:`without\ncreating a template`}),` in the dashboard. You provide the rendered HTML\nyourself and Minimo handles dispatch, delivery, and tracking.`]}),`\n`,_jsx(_components.p,{children:`Typical use cases:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Server-side rendered receipts`}),`: invoices, order confirmations, shipping notifications`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Authentication flows`}),`: magic links, OTP delivery, email verification`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Internal notifications`}),`: alerts produced by your own background jobs`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Anything dynamic enough to not fit a pre-defined template`})}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Tracking (open pixel + click rewriting) is injected `,_jsx(_components.strong,{children:`server-side`}),`. Send your raw HTML as-is: don’t pre-rewrite\nlinks or append a pixel yourself. Click rewriting follows your `,_jsx(_components.strong,{children:`Settings → Tracking → Email`}),` switch (on by default).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before You Start`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Create an API key with the `,_jsx(_components.strong,{children:`Transactional`}),` permission in `,_jsx(_components.strong,{children:`Developer → API keys`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Nothing else to set up: Minimo sends the email. Until you verify a sending domain, it goes out from a shared Minimo\naddress with your workspace’s name; to send from your own domain see\n`,_jsx(_components.a,{href:`/embedded/senders-and-sending`,children:`Senders and domains`}),`.`]}),`\n`,_jsx(_components.li,{children:`Have your HTML body ready. Minimo does not render templates for this endpoint.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`sending-for-one-of-your-customers`,children:`Sending for one of your customers`}),`\n`,_jsxs(_components.p,{children:[`If your app sends email for its own customers (for example restaurants), add `,_jsx(_components.code,{children:`tenant`}),` with your id for that customer.\nOnce your `,_jsx(_components.a,{href:`/embedded/quickstart`,children:`widget settings`}),` are saved, the recipient becomes that customer’s guest, and\nthe email counts in that customer’s history and statistics and in `,_jsx(_components.code,{children:`GET /public/v1/messages/list?tenant=…`}),`. Minimo does\nnot check marketing consent on this endpoint: use it for service emails (confirmations, reminders). See\n`,_jsx(_components.a,{href:`/embedded/start-here#which-way-to-send`,children:`Start here`}),` for the other ways to send.`]}),`\n`,_jsxs(_components.p,{children:[`To send guests’ replies to your customer, add `,_jsx(_components.code,{children:`replyTo`}),`, for example\n`,_jsx(_components.code,{children:`\"replyTo\": \"Trattoria da Mario \u003ctrattoriadamario@gmail.com>\"`}),`. Any mailbox works, also one outside your verified domains.`]}),`\n`,_jsxs(_components.p,{children:[`To show the customer’s name as the sender, add `,_jsx(_components.code,{children:`fromName`}),`, for example `,_jsx(_components.code,{children:`\"fromName\": \"Trattoria da Mario\"`}),`. It works\nbefore you verify a domain too. Without it, guests see your workspace’s name.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-server-does-to-your-html`,children:`What the Server Does to Your HTML`}),`\n`,_jsxs(_components.p,{children:[`When you send `,_jsx(_components.code,{children:`html`}),`, the backend:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Resolves placeholders`}),`: `,_jsx(_components.code,{children:`{{UNSUBSCRIBE_URL}}`}),`, `,_jsx(_components.code,{children:`{{PREFERENCES_URL}}`}),`, and `,_jsx(_components.code,{children:`{{FAKE_IMAGE_URL}}`}),` are replaced with the per-recipient tracked URLs.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Strips any pre-existing tracking pixel`}),`: an `,_jsx(_components.code,{children:`\u003cimg>`}),` whose `,_jsx(_components.code,{children:`src`}),` matches the Minimo open-pixel pattern is removed so it can’t double-fire.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Rewrites tracked anchors`}),`: every `,_jsx(_components.code,{children:`\u003ca href>`}),` pointing to `,_jsx(_components.code,{children:`http(s)`}),` or a relative URL is replaced with a click-tracking URL. `,_jsx(_components.code,{children:`mailto:`}),`, fragment-only (`,_jsx(_components.code,{children:`#…`}),`), and pre-existing `,_jsx(_components.code,{children:`/api/click/*`}),` links are left alone. This step runs only while click tracking is on in `,_jsx(_components.strong,{children:`Settings → Tracking → Email`}),` (the default); when you turn it off, links go out exactly as you wrote them, while the placeholders above and the open pixel still apply.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Appends the open-tracking pixel`}),` at the end of `,_jsx(_components.code,{children:`\u003cbody>`}),` (or at the document root if no `,_jsx(_components.code,{children:`\u003cbody>`}),` exists).`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The recipient receives the final HTML; analytics flow into `,_jsx(_components.code,{children:`GET /public/v1/emails/{id}/stats`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.minimo.it/public/v1/emails`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer mn-{apiClientId}-{secret}'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"to\": \"customer@example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"subject\": \"Your receipt\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"html\": \"\u003cp>Thanks for your purchase. \u003ca href=\\\\\"https://example.com/receipt/12345\\\\\">View receipt\u003c/a>\u003c/p>\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-shape`,children:`Response Shape`}),`\n`,_jsxs(_components.p,{children:[`A request that passes validation answers HTTP `,_jsx(_components.code,{children:`201`}),`, also when the provider then rejects the message: read `,_jsx(_components.code,{children:`status`}),`\n(`,_jsx(_components.code,{children:`sent`}),` or `,_jsx(_components.code,{children:`failed`}),`) to know what happened.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DMPNEF8\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"messageId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0100019c8b3d4a4f-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statsUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/public/v1/emails/DMPNEF8/stats\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`When the provider rejects the message you still get back the same `,_jsx(_components.code,{children:`id`}),`, so the delivery row remains queryable:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DMPNEF8\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"failureReason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Email address is not verified.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statsUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/public/v1/emails/DMPNEF8/stats\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Order receipt with embedded link`,id:`order-receipt-with-embedded-link`,children:[_jsxs(_components.p,{children:[`Render the receipt server-side and post it raw: Minimo rewrites the `,_jsx(_components.code,{children:`View receipt`}),` anchor into a tracked link.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"customer@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subject\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Receipt for ORD-12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"html\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003ch1>Thanks, Jane!\u003c/h1>\u003cp>Your order \u003cstrong>ORD-12345\u003c/strong> is on the way.\u003c/p>\u003cp>\u003ca href=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`https://shop.example.com/orders/ORD-12345`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`>Track your order\u003c/a>\u003c/p>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),_jsxs(Accordion,{title:`Magic-link sign-in`,id:`magic-link-sign-in`,children:[_jsx(_components.p,{children:`Override the sender per request to brand the email for a specific product surface.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"newuser@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subject\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sign in to Acme\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"html\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cp>Hi! Click \u003ca href=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`https://app.example.com/auth?token=eyJ...`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`>here\u003c/a> to sign in. Link expires in 15 minutes.\u003c/p>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fromAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"no-reply@acme.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fromName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Sign-In\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),_jsxs(Accordion,{title:`Internal alert from a background job`,id:`internal-alert-from-a-background-job`,children:[_jsx(_components.p,{children:`Plain HTML with a single CTA is enough: the open and click events surface in the stats endpoint.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ops@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subject\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[ALERT] Queue depth above threshold\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"html\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cp>Worker queue at 12,400 jobs.\u003c/p>\u003cp>\u003ca href=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`https://admin.example.com/jobs`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`>Open dashboard\u003c/a>\u003c/p>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Worker queue at 12,400 jobs. Open dashboard: https://admin.example.com/jobs\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(Heading,{level:`3`,id:`pair-every-send-with-a-statsurl-lookup`,children:[`Pair every send with a `,_jsx(_components.code,{children:`statsUrl`}),` lookup`]}),`\n`,_jsxs(_components.p,{children:[`The response includes `,_jsx(_components.code,{children:`statsUrl`}),`. Persist the `,_jsx(_components.code,{children:`id`}),` (or the full `,_jsx(_components.code,{children:`statsUrl`}),`) alongside whatever business object triggered the send (order id, user id, etc.) so you can correlate opens and clicks later.`]}),`\n`,_jsxs(Heading,{level:`3`,id:`handle-the-failed-branch`,children:[`Handle the `,_jsx(_components.code,{children:`failed`}),` branch`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`status: \"failed\"`}),` means the provider rejected the message, usually a malformed recipient, an unverified sender, or a hard bounce. Surface `,_jsx(_components.code,{children:`failureReason`}),` to your operators, then either retry with corrected data or log the failure.`]}),`\n`,_jsx(Heading,{level:`3`,id:`keep-html-self-contained`,children:`Keep HTML self-contained`}),`\n`,_jsxs(_components.p,{children:[`Inline your CSS. Many email clients drop `,_jsx(_components.code,{children:`\u003cstyle>`}),` blocks. Test in major clients (Gmail, Apple Mail, Outlook) before going live.`]}),`\n`,_jsxs(Heading,{level:`3`,id:`provide-a-text-fallback-for-deliverability`,children:[`Provide a `,_jsx(_components.code,{children:`text`}),` fallback for deliverability`]}),`\n`,_jsx(_components.p,{children:`Spam filters reward multipart messages. Adding a plain-text alternative reduces the chance of landing in the junk folder.`}),`\n`,_jsx(Heading,{level:`3`,id:`don’t-double-track`,children:`Don’t double-track`}),`\n`,_jsxs(_components.p,{children:[`If your HTML already contains `,_jsx(_components.code,{children:`/api/click/*`}),` URLs or an open pixel from a previous Minimo send, leave them alone: the server detects and skips them. Inserting your own tracking on top is unnecessary.`]}),`\n`,_jsx(Heading,{level:`2`,id:`common-errors`,children:`Common Errors`}),`\n`,_jsxs(_components.p,{children:[`Errors use the `,_jsx(_components.a,{href:`/api-reference/overview/conventions`,children:`standard error body`}),` `,_jsx(_components.code,{children:`{ \"status\": \"FAIL\", \"message\": \"\u003cCODE>\", \"userMessage\": \"…\" }`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Answer`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`400 INVALID_PARAMETERS`})}),_jsxs(_components.td,{children:[`A required field is missing or invalid (for example `,_jsx(_components.code,{children:`to`}),` is not an email).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`401 INVALID_TOKEN`})}),_jsxs(_components.td,{children:[`Wrong key, or the key does not have the `,_jsx(_components.strong,{children:`Transactional`}),` permission.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`402 QUOTA_EXCEEDED`})}),_jsx(_components.td,{children:`100 emails today and no credit top-up yet.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`422 SENDER_NOT_ALLOWED`}),` and other `,_jsx(_components.code,{children:`SENDER_*`}),` codes`]}),_jsxs(_components.td,{children:[`The sender is not under a verified domain of your workspace. See `,_jsx(_components.a,{href:`/embedded/errors#sending`,children:`Errors and limits`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 INVALID_REPLY_TO`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`replyTo`}),` is not a valid email address. Nothing is sent.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`201`}),` with `,_jsx(_components.code,{children:`\"status\": \"failed\"`})]}),_jsxs(_components.td,{children:[`The provider rejected the message; see `,_jsx(_components.code,{children:`failureReason`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/messaging-channels/email/html-stats`,children:`Get One-Shot Email Statistics`}),`: poll opens and clicks for a delivery`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/messaging-channels/email/send-template`,children:`Send Email Template`}),`: same idea, but starting from a dashboard template`]}),`\n`]})]})}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":"Send One-Shot HTML Email","description":"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required","openapi":"post /public/v1/emails","href":"/api-reference/messaging-channels/email/send-html"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Before You Start","slug":"before-you-start","depth":2,"children":[]},{"title":"Sending for one of your customers","slug":"sending-for-one-of-your-customers","depth":2,"children":[]},{"title":"What the Server Does to Your HTML","slug":"what-the-server-does-to-your-html","depth":2,"children":[]},{"title":"Example Request","slug":"example-request","depth":2,"children":[]},{"title":"Response Shape","slug":"response-shape","depth":2,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[{"title":"Pair every send with a statsUrl lookup","slug":"pair-every-send-with-a-statsurl-lookup","depth":3,"children":[]},{"title":"Handle the failed branch","slug":"handle-the-failed-branch","depth":3,"children":[]},{"title":"Keep HTML self-contained","slug":"keep-html-self-contained","depth":3,"children":[]},{"title":"Provide a text fallback for deliverability","slug":"provide-a-text-fallback-for-deliverability","depth":3,"children":[]},{"title":"Don’t double-track","slug":"don’t-double-track","depth":3,"children":[]}]},{"title":"Common Errors","slug":"common-errors","depth":2,"children":[]},{"title":"Related Endpoints","slug":"related-endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Send a one-shot HTML email","operationId":"sendHtmlEmail","description":"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required","requestBody":"4d93dd48-2486-4ba2-bae3-6630add7a4ec","responses":{"201":"4d42f5ee-5209-4eb5-9230-06e146785697","400":"6ebdfcef-ea7b-4925-8ba8-9a4bfd06c7e7","401":"8480aa5a-21ef-4ac0-ae86-9ebb5c10ec84","403":"44431be9-8044-4e6b-849e-a2dcb9ee8beb","422":"46034457-c6f2-441d-a761-2dd211d41d27","500":"519d799a-355b-4f48-896c-02895cddbdaf"},"security":["b7b4186e-f6da-4740-af85-10874a4a63b5"],"method":"post","type":"path","servers":["93d7e179-b461-4fe6-a9f4-9ee3ead61044"],"path":"/public/v1/emails","baseUrlOptions":["https://api.minimo.it"],"title":"Send a one-shot HTML email","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["to","subject","html"],"properties":{"to":{"type":"string","format":"email","description":"Recipient email address.","isRequired":true,"uniqueKey":"to","typeLabel":"string\u003cemail>"},"subject":{"type":"string","description":"Email subject line.","isRequired":true,"uniqueKey":"subject","typeLabel":"string"},"html":{"type":"string","description":"Pre-rendered HTML body. The server injects the open\npixel and rewrites anchor `href`s — do not pre-process\nthem on your side.\n","isRequired":true,"uniqueKey":"html","typeLabel":"string"},"text":{"type":"string","description":"Plain-text fallback for clients without HTML support.","uniqueKey":"text","typeLabel":"string"},"fromAddress":{"type":"string","format":"email","description":"Sender address for this send. Must be under a VERIFIED sending\ndomain of your workspace, otherwise `422` (never a silent\nfallback). Omit every sender field to use the workspace default.\nAt most one of `senderId`, `from`, `fromAddress`.\n","uniqueKey":"fromAddress","typeLabel":"string\u003cemail>"},"from":{"type":"string","description":"Same as `fromAddress`, also accepting `\"Name \u003caddress@domain>\"`.\n","example":"Trattoria Da Mario \u003cprenotazioni@trattoriadamario.it>","uniqueKey":"from","typeLabel":"string"},"senderId":{"type":"integer","description":"Id of a sender from `GET /public/v1/domains/{id}/senders`. Its\ndomain must be verified, otherwise `422`.\n","example":34,"uniqueKey":"senderId","typeLabel":"integer"},"fromName":{"type":"string","description":"Per-request sender display name override.","uniqueKey":"fromName","typeLabel":"string"},"tenant":{"type":"string","maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","description":"Your own reference for the customer this send belongs to.\nStored on the message; filter with\n`GET /public/v1/messages/list?tenant=`.\n","example":"restaurant-4812","uniqueKey":"tenant","typeLabel":"string"},"replyTo":{"type":"string","maxLength":320,"description":"Where replies go. \"Name \u003caddress>\" or a bare address. Any\nmailbox works, also one outside your verified domains (for\nexample the restaurant's own Gmail). Omit it to keep your\nworkspace default. A malformed value answers\n`422 INVALID_REPLY_TO` and nothing is sent.\n","example":"Trattoria da Mario \u003ctrattoriadamario@gmail.com>","uniqueKey":"replyTo","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"minimal":{"title":"minimal","summary":"Minimal payload","value":{"to":"customer@example.com","subject":"Your receipt","html":"\u003cp>Thanks for your purchase. \u003ca href=\"https://example.com/receipt/12345\">View receipt\u003c/a>\u003c/p>"}},"withSenderOverride":{"title":"withSenderOverride","summary":"With sender override","value":{"to":"customer@example.com","subject":"Your receipt","html":"\u003cp>Receipt\u003c/p>","text":"Thanks for your purchase. View your receipt at https://example.com/receipt/12345","fromAddress":"hello@example.com","fromName":"Acme Receipts"}},"perTenantSender":{"title":"perTenantSender","summary":"Send from a tenant's domain, tagged with the tenant","value":{"to":"guest@example.com","subject":"Your table is confirmed","html":"\u003cp>See you on Friday at 20:30.\u003c/p>","senderId":34,"tenant":"restaurant-4812","replyTo":"Trattoria da Mario \u003ctrattoriadamario@gmail.com>"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4d42f5ee-5209-4eb5-9230-06e146785697":{"description":"Delivery accepted by the queue. Check `data.status` to tell\nwhether the provider actually accepted the message.\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Opaque sqid-encoded delivery id.","example":"DMPNEF8","uniqueKey":"data.id","typeLabel":"string"},"status":{"type":"string","enum":["sent","failed"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"messageId":{"type":"string","description":"Provider-side message id (e.g. AWS SES MessageId). Populated on success.","uniqueKey":"data.messageId","typeLabel":"string"},"failureReason":{"type":"string","description":"Populated when `status = \"failed\"`.","uniqueKey":"data.failureReason","typeLabel":"string"},"statsUrl":{"type":"string","description":"Relative URL to poll for delivery statistics.","example":"/public/v1/emails/DMPNEF8/stats","uniqueKey":"data.statsUrl","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sent":{"title":"sent","summary":"Successful dispatch","value":{"data":{"id":"DMPNEF8","status":"sent","messageId":"0100019c8b3d4a4f-...","statsUrl":"/public/v1/emails/DMPNEF8/stats"}}},"failed":{"title":"failed","summary":"Provider rejected the message","value":{"data":{"id":"DMPNEF8","status":"failed","failureReason":"Email address is not verified.","statsUrl":"/public/v1/emails/DMPNEF8/stats"}}}},"exampleType":"examples"}},"exampleType":"examples"},"6ebdfcef-ea7b-4925-8ba8-9a4bfd06c7e7":{"description":"Validation error in the request body.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"to must be an email","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"to must be an email"}}},"exampleType":"generated"}},"exampleType":"generated"},"8480aa5a-21ef-4ac0-ae86-9ebb5c10ec84":{"description":"Missing or invalid API key.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"44431be9-8044-4e6b-849e-a2dcb9ee8beb":{"description":"API key lacks the `TRANSACTIONAL` permission.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"46034457-c6f2-441d-a761-2dd211d41d27":{"description":"The chosen sender is refused (`SENDER_NOT_ALLOWED`,\n`SENDER_NOT_FOUND`, `SENDER_DOMAIN_NOT_VERIFIED`,\n`SENDER_PARAM_CONFLICT`, `INVALID_SENDER_ADDRESS`), or `replyTo`\nis malformed (`INVALID_REPLY_TO`). Nothing is sent.\n","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"519d799a-355b-4f48-896c-02895cddbdaf":{"description":"Server-side configuration error (e.g. `WEB_APP_URL` not set).","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"b7b4186e-f6da-4740-af85-10874a4a63b5":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"mn-API_CLIENT_ID-API_KEY","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"93d7e179-b461-4fe6-a9f4-9ee3ead61044":{"url":"https://api.minimo.it"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"mn-API_CLIENT_ID-API_KEY","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openApi.yml"},"subdomain":"minimo","siteName":"Minimo Docs","title":"Send One-Shot HTML Email - Minimo Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T17:34:19.446Z","originalFileLocation":"api-reference/messaging-channels/email/send-html.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=\"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required\">\u003cmeta data-mint-head name=\"application-name\" content=\"Minimo 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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send One-Shot HTML Email - Minimo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Minimo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://minimo.mintlify.site/_mintlify/api/og/v2?division=Email\u0026amp;title=Send+One-Shot+HTML+Email\u0026amp;description=Dispatch+a+single+transactional+email+by+sending+a+pre-rendered+HTML+payload%2C+no+template+required\u0026amp;theme=06602465e78cf5662614cb8c\u0026amp;signature=1829f8cdce3d383b64a3d87d2d6f4b29781fd78c384f86de7b28e07ef03d3e08\">\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 One-Shot HTML Email - Minimo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://minimo.mintlify.site/_mintlify/api/og/v2?division=Email\u0026amp;title=Send+One-Shot+HTML+Email\u0026amp;description=Dispatch+a+single+transactional+email+by+sending+a+pre-rendered+HTML+payload%2C+no+template+required\u0026amp;theme=06602465e78cf5662614cb8c\u0026amp;signature=1829f8cdce3d383b64a3d87d2d6f4b29781fd78c384f86de7b28e07ef03d3e08\">\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/minimo/CJfiX4gOkuK9_RYe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Minimo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/messaging-channels/email/send-html.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.minimo.it/#organization\",\"name\":\"Minimo Docs\",\"url\":\"https://docs.minimo.it\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/minimo/_5TQWO7ZAmNbow_0/logo/light.svg?fit=max\u0026auto=format\u0026n=_5TQWO7ZAmNbow_0\u0026q=85\u0026s=770ea7f424284ce6f88684bb97af23f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.minimo.it#website\",\"name\":\"Minimo Docs\",\"url\":\"https://docs.minimo.it\",\"publisher\":{\"@id\":\"https://docs.minimo.it/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html#webpage\",\"url\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html\",\"name\":\"Send One-Shot HTML Email\",\"description\":\"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required\",\"dateModified\":\"2026-11-15T17:34:19.446Z\",\"isPartOf\":{\"@id\":\"https://docs.minimo.it#website\"},\"breadcrumb\":{\"@id\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messaging Channels\",\"item\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-template\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Email\",\"item\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-template\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Send One-Shot HTML Email\",\"item\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html#apireference\",\"headline\":\"Send One-Shot HTML Email\",\"name\":\"Send One-Shot HTML Email\",\"description\":\"Dispatch a single transactional email by sending a pre-rendered HTML payload, no template required\",\"url\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html\",\"mainEntityOfPage\":{\"@id\":\"https://docs.minimo.it/api-reference/messaging-channels/email/send-html#webpage\"},\"dateModified\":\"2026-11-15T17:34:19.446Z\",\"publisher\":{\"@id\":\"https://docs.minimo.it/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.minimo.it#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Minimo Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Minimo Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/messaging-channels/email/send-html.md","siteName":"Minimo Docs","nav":{"global":{"anchors":[{"anchor":"Sito Web","href":"https://minimo.it","icon":"desktop"},{"anchor":"Blog","href":"https://minimo.it/blog","icon":"newspaper"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Product","pages":[{"title":"Product","href":"/product/introduction"}]},{"tab":"Embedded for SaaS","pages":[{"title":"Embedded for SaaS","href":"/embedded/start-here"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/overview/introduction"},{"title":"Authentication \u0026 API Keys","href":"/api-reference/overview/authentication"},{"title":"API Conventions","href":"/api-reference/overview/conventions"}]},{"group":"Core Data","pages":[{"group":"Contacts","pages":[{"title":"Create or Update Contact","openapi":"post /public/v1/contacts","href":"/api-reference/core-data/contacts/upsert"},{"title":"Get Contact by Email","openapi":"get /public/v1/contacts/by-email/{email}","href":"/api-reference/core-data/contacts/get-by-email"},{"title":"Update Contact by ID","openapi":"put /public/v1/contacts/{id}","href":"/api-reference/core-data/contacts/update-by-id"},{"title":"Opt Out of Marketing","openapi":"post /public/v1/contacts/opt-out","href":"/api-reference/core-data/contacts/opt-out"},{"title":"Delete Contact","openapi":"delete /public/v1/contacts/{id}","href":"/api-reference/core-data/contacts/delete"}]},{"group":"Custom Fields","pages":[{"title":"List Custom Fields","openapi":"get /public/v1/custom-fields","href":"/api-reference/core-data/custom-fields/list"},{"title":"Create Custom Field","openapi":"post /public/v1/custom-fields","href":"/api-reference/core-data/custom-fields/create"}]}]},{"group":"Messaging Channels","pages":[{"group":"Email","pages":[{"title":"Send Email Template","openapi":"post /public/v1/templates/email/send","href":"/api-reference/messaging-channels/email/send-template"},{"title":"Send Transactional Email","openapi":"post /public/v1/transactionals","href":"/api-reference/messaging-channels/email/send-transactional"},{"title":"Create Email Template","href":"/api-reference/messaging-channels/email/create-template"},{"title":"List Email Templates","openapi":"get /public/v1/templates/email","href":"/api-reference/messaging-channels/email/list-templates"},{"title":"Get Email Template Stats","description":"View delivery, open, and click statistics for email templates","openapi":"get /public/v1/transactionals/{id}/stats","href":"/api-reference/messaging-channels/email/stats"},{"title":"Send One-Shot HTML Email","openapi":"post /public/v1/emails","href":"/api-reference/messaging-channels/email/send-html"},{"title":"Get One-Shot Email Statistics","description":"Poll delivery, open, and click metrics for a single HTML email sent via the one-shot endpoint","openapi":"get /public/v1/emails/{id}/stats","href":"/api-reference/messaging-channels/email/html-stats"},{"group":"Scheduled Emails","pages":[{"title":"List Scheduled Emails","openapi":"get /public/v1/transactionals/scheduled","href":"/api-reference/messaging-channels/email/list-scheduled"},{"title":"Get Scheduled Email","openapi":"get /public/v1/transactionals/scheduled/{id}","href":"/api-reference/messaging-channels/email/get-scheduled"},{"title":"Cancel Scheduled Email","openapi":"delete /public/v1/transactionals/scheduled/{id}","href":"/api-reference/messaging-channels/email/cancel-scheduled-email"},{"title":"Cancel Scheduled Emails","openapi":"delete /public/v1/transactionals/scheduled","href":"/api-reference/messaging-channels/email/cancel-scheduled-emails"}]}]},{"group":"WhatsApp","pages":[{"title":"List WhatsApp Senders","openapi":"get /public/v1/templates/whatsapp/senders","href":"/api-reference/messaging-channels/whatsapp/list-senders"},{"title":"Send WhatsApp Template","openapi":"post /public/v1/templates/whatsapp/send","href":"/api-reference/messaging-channels/whatsapp/send-template"},{"title":"List WhatsApp Templates","openapi":"get /public/v1/templates/whatsapp","href":"/api-reference/messaging-channels/whatsapp/list-templates"},{"title":"Inbound \u0026 Webhooks","href":"/api-reference/messaging-channels/whatsapp/inbound-webhooks"}]}]},{"group":"Domains","pages":[{"title":"List Domains","openapi":"get /public/v1/domains","href":"/api-reference/domains/list"},{"title":"Add Domain","openapi":"post /public/v1/domains","href":"/api-reference/domains/add"},{"title":"Get Domain","openapi":"get /public/v1/domains/{id}","href":"/api-reference/domains/get"},{"title":"Verify Domain","openapi":"post /public/v1/domains/{id}/verify","href":"/api-reference/domains/verify"},{"title":"Delete Domain","openapi":"delete /public/v1/domains/{id}","href":"/api-reference/domains/delete"},{"group":"Senders","pages":[{"title":"List Senders","openapi":"get /public/v1/domains/{id}/senders","href":"/api-reference/domains/list-senders"},{"title":"Add Sender","openapi":"post /public/v1/domains/{id}/senders","href":"/api-reference/domains/add-sender"},{"title":"Update Sender","openapi":"patch /public/v1/domains/{id}/senders/{senderId}","href":"/api-reference/domains/update-sender"},{"title":"Delete Sender","openapi":"delete /public/v1/domains/{id}/senders/{senderId}","href":"/api-reference/domains/delete-sender"}]},{"group":"Domain Popup","pages":[{"title":"Update Domain Popup Settings","openapi":"put /public/v1/domains/embed-settings","href":"/api-reference/domains/update-popup-settings"},{"title":"Get Domain Popup Settings","openapi":"get /public/v1/domains/embed-settings","href":"/api-reference/domains/get-popup-settings"},{"title":"Create Domain Popup Session","openapi":"post /public/v1/domains/embed-sessions","href":"/api-reference/domains/create-popup-session"}]}]},{"group":"Embedded API","pages":[{"group":"Widgets","pages":[{"title":"Update Widget Settings","openapi":"put /public/v1/widgets/settings","href":"/api-reference/embedded/widgets/update-settings"},{"title":"Get Widget Settings","openapi":"get /public/v1/widgets/settings","href":"/api-reference/embedded/widgets/get-settings"},{"title":"Create Widget Session","openapi":"post /public/v1/widgets/sessions","href":"/api-reference/embedded/widgets/create-session"},{"title":"Revoke Widget Session","openapi":"delete /public/v1/widgets/sessions/{id}","href":"/api-reference/embedded/widgets/revoke-session"}]},{"group":"Events","pages":[{"title":"Send Event","openapi":"post /public/v1/events","href":"/api-reference/embedded/events/send-event"},{"title":"List Scheduled Sends","openapi":"get /public/v1/scheduled-sends","href":"/api-reference/embedded/events/list-scheduled-sends"},{"title":"Cancel Scheduled Sends","openapi":"delete /public/v1/scheduled-sends","href":"/api-reference/embedded/events/cancel-scheduled-sends"}]},{"group":"Rules","pages":[{"title":"List Default Rules","openapi":"get /public/v1/automation-rules","href":"/api-reference/embedded/rules/list-default-rules"},{"title":"Save Default Rules","openapi":"put /public/v1/automation-rules","href":"/api-reference/embedded/rules/save-default-rules"},{"title":"Delete Default Rule","openapi":"delete /public/v1/automation-rules/{key}","href":"/api-reference/embedded/rules/delete-default-rule"},{"title":"List Tenant Rules","openapi":"get /public/v1/tenants/{tenant}/automations","href":"/api-reference/embedded/rules/list-tenant-rules"},{"title":"Save Tenant Rules","openapi":"put /public/v1/tenants/{tenant}/automations","href":"/api-reference/embedded/rules/save-tenant-rules"},{"title":"Delete Tenant Rule","openapi":"delete /public/v1/tenants/{tenant}/automations/{key}","href":"/api-reference/embedded/rules/delete-tenant-rule"}]},{"group":"Tenants","pages":[{"title":"Get Tenant Profile","openapi":"get /public/v1/tenants/{tenant}","href":"/api-reference/embedded/tenants/get-profile"},{"title":"Save Tenant Profile","openapi":"put /public/v1/tenants/{tenant}","href":"/api-reference/embedded/tenants/save-profile"},{"title":"Record Guest Consent","openapi":"put /public/v1/tenants/{tenant}/subscriptions","href":"/api-reference/embedded/tenants/record-consent"},{"title":"Get Guest Consent","openapi":"get /public/v1/tenants/{tenant}/subscriptions","href":"/api-reference/embedded/tenants/get-consent"},{"title":"Get Tenant Stats","openapi":"get /public/v1/tenants/{tenant}/stats","href":"/api-reference/embedded/tenants/get-stats"},{"title":"Get Tenant Reputation","openapi":"get /public/v1/tenants/{tenant}/reputation","href":"/api-reference/embedded/tenants/get-reputation"},{"title":"Get Marketing Hold","openapi":"get /public/v1/tenants/{tenant}/marketing-hold","href":"/api-reference/embedded/tenants/get-marketing-hold"},{"title":"List Sent Messages","openapi":"get /public/v1/messages/list","href":"/api-reference/embedded/tenants/list-messages"}]}]},{"group":"Inbox","pages":[{"group":"Threads","pages":[{"title":"List Threads","openapi":"get /public/v1/inbox/threads","href":"/api-reference/inbox/list-threads"},{"title":"Search Threads","openapi":"get /public/v1/inbox/threads/search","href":"/api-reference/inbox/search-threads"},{"title":"Get Thread","openapi":"get /public/v1/inbox/threads/{threadId}","href":"/api-reference/inbox/get-thread"},{"title":"Update Thread","openapi":"patch /public/v1/inbox/threads/{threadId}","href":"/api-reference/inbox/update-thread"},{"title":"Turn AI Off or On","openapi":"post /public/v1/inbox/threads/{threadId}/ai","href":"/api-reference/inbox/set-ai"},{"title":"Reply to Thread","openapi":"post /public/v1/inbox/threads/{threadId}/reply","href":"/api-reference/inbox/reply"}]}]},{"group":"Connect a Bot (WhatsApp)","pages":[{"title":"Overview","href":"/api-reference/whatsapp-transport/overview"},{"group":"Messages","pages":[{"title":"Send a Message","openapi":"post /public/v1/templates/whatsapp/send","href":"/api-reference/whatsapp-transport/send"},{"title":"Download Media","openapi":"get /public/v1/media/{id}","href":"/api-reference/whatsapp-transport/media"}]},{"group":"Webhooks","pages":[{"title":"Register Webhook","openapi":"post /public/v1/webhooks/registrations","href":"/api-reference/whatsapp-transport/webhook-register"},{"title":"List Webhooks","openapi":"get /public/v1/webhooks/registrations","href":"/api-reference/whatsapp-transport/webhook-list"},{"title":"Get Webhook","openapi":"get /public/v1/webhooks/registrations/{id}","href":"/api-reference/whatsapp-transport/webhook-get"},{"title":"Update Webhook","openapi":"put /public/v1/webhooks/registrations/{id}","href":"/api-reference/whatsapp-transport/webhook-update"},{"title":"Delete Webhook","openapi":"delete /public/v1/webhooks/registrations/{id}","href":"/api-reference/whatsapp-transport/webhook-delete"},{"title":"Webhook Delivery Logs","openapi":"get /public/v1/webhooks/registrations/{id}/logs","href":"/api-reference/whatsapp-transport/webhook-logs"},{"title":"Webhook Events","href":"/api-reference/whatsapp-transport/webhooks"}]},{"group":"Conversations","pages":[{"title":"List Conversations","openapi":"get /public/v1/whatsapp/conversations","href":"/api-reference/whatsapp-transport/conversations"},{"title":"List Conversation Messages","openapi":"get /public/v1/whatsapp/conversations/{chatId}/messages","href":"/api-reference/whatsapp-transport/conversation-messages"}]},{"title":"Handle Unsubscribe Requests","href":"/api-reference/whatsapp-transport/opt-out"},{"title":"Notes \u0026 Limits","href":"/api-reference/whatsapp-transport/notes"}]},{"group":"Legacy (Deprecated)","pages":[{"title":"Legacy API (Deprecated)","icon":"triangle-exclamation","href":"/api-reference/legacy/introduction"},{"title":"Send Email (Deprecated)","openapi":"post /api/transactionals","href":"/api-reference/legacy/send-email-deprecated"},{"title":"List Email Transactionals (Deprecated)","href":"/api-reference/legacy/list-email-transactionals-deprecated"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/connect-your-agent"}]}]},"basePath":"","title":"Send One-Shot HTML Email - Minimo Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}