Webhooks

Create an endpoint with URL + events (optionally routeId to receive only that route’s traffic).

Signature

Deliveries include:

X-Evre-Signature: sha256=<hmac hex of raw body>

Verify with the endpoint secret shown once at create time.

Events

Typical types: email.sent, email.delivered, email.bounced, email.complained, email.opened, email.clicked, email.received (see OpenAPI WebhookEventType).

email.opened / email.clicked are opt-in engagement events (pixel + link rewrite). Enable per send with trackOpens / trackClicks, or set project defaults via PATCH /projects/{id}. Delivery status is unchanged; events append to the message timeline.

email.received carries a compact payload (email_id, from, to, subject). Fetch full MIME-parsed content with GET /emails/received/{id} — see Inbound email.

Attempts and replay

• GET /webhooks/{id}/attempts — delivery log
• POST /webhooks/{id}/replay — retry last failed attempt

const attempts = await evre.webhooks.attempts(id);
await evre.webhooks.replay(id);