All storiesGuides

Your first transactional email, from event to delivery

A practical path from an application event to a Sendar request, with the checks that matter before your first production send.

Sendar2 min read

Published 14 January 2026 · Updated 4 October 2026

An order is confirmed in your application. The customer refreshes their inbox. Between those two moments are several separate responsibilities: deciding that the event happened, constructing the right message, submitting it, and checking what happened next. A useful email integration makes each step visible.

Start with one event

Choose a workflow with a clear source of truth, such as a completed booking. Trigger the email after the booking record has been committed. Sending before that transaction succeeds can produce a confirmation for a booking that does not exist. Store the event identifier alongside the email attempt so you can investigate it later.

For your first integration, use one recipient you control. Keep the subject, HTML and plain-text body short enough to inspect. You can introduce templates and additional workflows after the basic path works.

Prepare the sender

Create a Sendar account, add a sending domain and install the DNS records shown in the dashboard. Wait for verification before using that domain in a live request. Create an API key and store it in your server environment, not in browser code or a public repository.

The application sends a server-side POST request to /api/emails with a Bearer token. Supply the sender, recipient array, subject and message body. Our language guides contain the exact request format, so you can start with the stack you already use.

Make the result traceable

Record the returned message ID and status. Use a stable Idempotency-Key for a single message event, and preserve the same payload if you retry. A timeout is not evidence that the message was never processed. Check the email history before creating another attempt.

Provider acceptance and delivery are different stages. Inspect available delivery events and bounce information rather than treating a successful HTTP response as proof of inbox placement. This distinction is especially useful when a customer says an email did not arrive.

Expand only after the path works

Test a validation failure, a missing credential and a duplicate event locally. Decide who receives operational alerts when a send fails. Then connect the workflow to real application events. A small integration with clear failure handling is a better starting point than many templates with no way to explain what happened to them.

Keep building

S.
Sendar

Tools and practical advice for application email.