Webhooks
email.delivered
Sent when Amazon SES reports that the recipient's mail server accepted your email. The payload carries the SMTP response, SES's own timestamp and how long SES took.
What the event tells you
The receiving server said yes
Delivered means the recipient's mail server accepted the message. It does not mean the message was read or reached the inbox rather than a spam folder.
The status changes first
The email moves to delivered before the event is sent, so data.status already reads delivered.
The SMTP response is included
smtp_response is the receiving server's acceptance response, as SES relays it.
SES sends only
Delivery notices come from Amazon SES, so the event covers mail sent through the managed pool.
Fields in data
- Common fields
- email_id, message_id, from, to, subject, status, tags, created_at.
- smtp_response
- The receiving server's acceptance response.
- processing_time_ms
- How long SES took to deliver, in milliseconds.
- timestamp
- SES's own time for the delivery.
- provider
- ses
"status": "delivered",
"smtp_response": "<response from the receiving server>",
"processing_time_ms": <milliseconds>,
"provider": "ses"PostFrame, answered
What is in the email.delivered payload?
The common fields (email_id, message_id, from, to, subject, status, tags, created_at) plus smtp_response, processing_time_ms, timestamp and provider.
How do I verify the request came from PostFrame?
Every request carries X-PostFrame-Signature (v1=<hex>) and X-PostFrame-Timestamp. Recompute HMAC-SHA256 over "<timestamp>.<body>" with the endpoint's signing secret, using the body exactly as received, and compare in constant time. The Node and Python snippets shown in the dashboard check this same scheme. The signing secret can be rotated through the API.
What happens if my endpoint is down?
PostFrame retries a failed delivery up to 4 times, waiting 10, 20, 40 and 80 seconds, and the endpoint's delivery log keeps one entry per delivery with the event type, last HTTP status, timing and attempt number. After the last attempt the event is not sent again. Each attempt times out after 10 seconds and redirects are not followed.
Can I try the endpoint before real traffic arrives?
Yes. Each endpoint has a Test action that sends a test event to your URL. Emails sent in test mode, for example with a pf_test_ API key, never dispatch webhooks.
Run your business from one place.
Five plans, 25 launch apps, one dashboard. Change tiers any time.
From $0 · Basic $9.95/mo · Upgrade or downgrade any time