Charchy Senddocs

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*string

The event's id (evt_…), the same on every retry. Dedupe by it.

webhook-timestamp*string

Unix seconds when this attempt was signed. Reject if older than 5 minutes.

webhook-signature*string

One or more v1,<base64 HMAC-SHA256 of "id.timestamp.body">, separated by spaces (two during a secret rotation).

application/json
  1. body
id*string

Same as the webhook-id header.

created_at*string

When it happened. Order events by it.

Formatdate-time
test?boolean

Present 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
Value in"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.

Example Requests
POST/email-event
Request Body
application/json
{  "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"  }}
Header Parameters
{  "webhook-id": "string",  "webhook-timestamp": "string",  "webhook-signature": "string"}