Transactional email API
Send receipts, password resets and other product emails from your server with a secret server key, and retry safely without sending twice.

RECTIFY_SERVER_KEY. Then select Done.
rsk_ and is shown only this once. Rectify keeps only a fingerprint of it, so nobody can see it again, including you. Each project has one server key.POST https://api.rectify.so/v1/messages/transactionalcurl -X POST https://api.rectify.so/v1/messages/transactional \
-H "Authorization: Bearer $RECTIFY_SERVER_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042-receipt" \
-d '{
"to": "[email protected]",
"subject": "Your receipt for order 1042",
"html": "<p>Thanks for your order, Jane.</p>",
"templateKey": "receipt"
}'
200:{ "messageId": "6a1f2c3d4e5f6a7b8c9d0e1f", "status": "sent", "deduplicated": false }202 with a reason:{ "messageId": "6a1f2c3d4e5f6a7b8c9d0e20", "status": "suppressed", "deduplicated": false, "reason": "suppressed:hard_bounce" }Idempotency-Key that's unique to it, such as order-1042-receipt. If you send the same key again, Rectify doesn't send a second email. It returns the first one's messageId and status, with "deduplicated": true. That makes it safe to retry after a timeout or a network error.transactional.The response is 202 and no email arrived
status and reason in the response. A suppressed address stays blocked until you remove it under Messaging, Suppressions. Only Owners and Admins can remove one.I sent the same email twice by mistake
Idempotency-Key that's unique to each email. Retries with that key never send a second time.The email came from Rectify, not my domain
Was this helpful?
Your feedback shapes what we write next.
Related articles
Use your own Twilio and Resend accounts
Connect Twilio for phone calls and text messages, and Resend for email campaigns and email from your own domain.
Send from your own domain
Connect your Resend account so campaigns, and if you like your other project emails, go out from an address on your own domain.
Use the Automation page
Score your leads, post contact activity to Slack and send events to your own systems with signed webhooks.
Contacts API
Create and update contacts from your server, backfill up to 500 at a time, and attach your own records such as subscriptions or orders.