From 74897da556dcc625ffdaea4feeccd8089892248a Mon Sep 17 00:00:00 2001 From: George Hartley Date: Tue, 28 Jul 2026 22:04:56 +1000 Subject: [PATCH] docs(guides): document idempotency_key on transactional sends + 1 Sep cutoff --- guides/sending-emails.mdx | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/guides/sending-emails.mdx b/guides/sending-emails.mdx index 50e56b3..eb9648c 100644 --- a/guides/sending-emails.mdx +++ b/guides/sending-emails.mdx @@ -29,10 +29,13 @@ curl -X POST https://api.nitrosend.com/v1/my/messages \ "to": "user@example.com", "subject": "Your receipt", "html": "

Thanks for your purchase

", - "body": "Thanks for your purchase" + "body": "Thanks for your purchase", + "idempotency_key": "receipt-order-1042" }' ``` +Always pass an `idempotency_key` (or an `Idempotency-Key` header): a stable value tied to the triggering event, such as `receipt-order-1042`. Retrying with the same key never sends a duplicate; reusing a key with a different payload returns a `409 idempotency_conflict`. Keyless sends are deprecated and will be rejected from **1 September 2026** (responses already carry `Deprecation` and `Sunset` headers). + ## Email editor The drag-and-drop editor lets you build responsive emails visually. Your brand theme (colors, fonts, logo) is applied automatically. All emails are rendered as MJML under the hood for maximum inbox compatibility.