Back to Webhooks
Webhook Event

email.delivered

Fires when the recipient's mail server accepts your email. PostFrame stamps the delivered time, stores the SMTP response, and sends the event to your endpoint with a signature you can verify.

Delivery Confirmation Event

Instant notification
Webhook fires within seconds of the receiving server accepting the message
Provider metadata
Includes which provider delivered the message and the SMTP response code
Status update first
The email moves to delivered and delivered_at is stamped before the webhook is queued
Timestamp
The event carries a unix timestamp; the email record keeps its created, sent and delivered times
Payload Fields
message_id
The provider's message identifier
to
The recipient list of the email
provider
ses, postmark, mailgun and so on
smtp_response
The receiving server's acceptance response. Every event also carries data.email_id, message_id, from, to, subject, status, tags and created_at
Questions

Common questions, straight answers.

What is in the email.delivered payload?

The common fields — email_id, message_id, from, to, subject, status, tags, created_at — plus smtp_response from the receiving server and the provider name.

How do I verify the webhook came from PostFrame?

Every delivery carries an X-PostFrame-Signature header of the form v1=<hex>. It is an HMAC-SHA256 of "<timestamp>.<body>" using the endpoint's signing secret, which you can rotate from the dashboard at any time.

What happens if my endpoint is down?

PostFrame retries five times with exponential backoff — 10, 20, 40, 80 and 160 seconds — and records every attempt, with the HTTP status and timing, in the endpoint's delivery log.

Can I try the endpoint before real traffic arrives?

Yes. Each webhook endpoint has a Test action that sends a sample event to your URL. Emails sent in test mode never dispatch webhooks, so your integration tests do not fire production hooks.

Run your business from one place.

Five plans, seventeen launch apps, one dashboard. Set up in under 5 minutes — change tiers any time.

From $0 · Basic $9.95/mo · Save 20% on annual billing · Upgrade or downgrade any time