Email events
Sent to your endpoint when an email changes state. `type` is one of `email.sent`, `email.delivered`, `email.delivery_delayed`, `email.bounced`, `email.complained`, `email.failed`, `email.suppressed`, `email.expired`, `email.canceled`. One event per recipient for `email.delivered`, `email.delivery_delayed`, `email.bounced`, `email.complained` and `email.suppressed` — `data.recipient` names the address. `email.sent`, `email.failed`, `email.expired` and `email.canceled` come once per email. Emails sent with a test key, and the magic addresses, fire these events too. Signed with the Standard Webhooks spec: verify `webhook-signature` against the raw body, reject timestamps older than 5 minutes, and dedupe by `webhook-id`. Order is not guaranteed. Answer 2xx within 5 seconds; `410 Gone` disables the endpoint. Requests carry `user-agent: Charchy-Webhooks/1.0 (+https://charchy.krd/docs/webhooks)`.
Sent to your endpoint when an email changes state. type is one of
email.sent, email.delivered, email.delivery_delayed,
email.bounced, email.complained, email.failed,
email.suppressed, email.expired, email.canceled.
One event per recipient for email.delivered,
email.delivery_delayed, email.bounced, email.complained and
email.suppressed — data.recipient names the address. email.sent,
email.failed, email.expired and email.canceled come once per
email. Emails sent with a test key, and the magic addresses, fire
these events too.
Signed with the Standard Webhooks spec: verify webhook-signature
against the raw body, reject timestamps older than 5 minutes, and
dedupe by webhook-id. Order is not guaranteed. Answer 2xx within
5 seconds; 410 Gone disables the endpoint. Requests carry
user-agent: Charchy-Webhooks/1.0 (+https://charchy.krd/docs/webhooks).
webhook-id*stringThe event's id (evt_…), the same on every retry. Dedupe by it.
webhook-timestamp*stringUnix seconds when this attempt was signed. Reject if older than 5 minutes.
webhook-signature*stringOne or more v1,<base64 HMAC-SHA256 of "id.timestamp.body">,
separated by spaces (two during a secret rotation).
application/json- body
id*stringSame as the webhook-id header.
created_at*stringWhen it happened. Order events by it.
date-timetest?booleanPresent and true on a sample from Send test event (no real email behind it). Whether a real email used a test key is data.test.
type*string"email.sent""email.delivered""email.delivery_delayed""email.bounced""email.complained""email.failed""email.suppressed""email.expired""email.canceled"data*Received. Do the work after answering.
{ "id": "evt_2b7k9x4m1q8w3n5p6r0s2t4v", "type": "email.delivered", "created_at": "2026-11-16T09:00:02.400Z", "data": { "email_id": "em_8f2k1x9q4w7m3n5p6r0s2t4v", "from": "Darin Game <orders@daringaming.com>", "to": [ "customer@example.com" ], "subject": "Your order #4821", "created_at": "2026-11-16T09:00:00.120Z", "tags": { "type": "order_confirmation" }, "test": false, "recipient": "customer@example.com" }}{ "webhook-id": "string", "webhook-timestamp": "string", "webhook-signature": "string"}