Webhooks
email.complained
Sent when a recipient marks your email as spam and Amazon SES reports it. PostFrame suppresses the address at once and sends you the feedback type and the provider.
What the event tells you
A complaint, not a guess
The event is sent only when the mailbox provider's complaint notice reaches PostFrame and its signature checks out.
The address is suppressed
PostFrame adds the address to your suppression list with the reason "complaint", so it is not sent to again.
The feedback type
complaint_feedback_type carries the type the mailbox provider reported, for example abuse.
Tags for attribution
The email's tags ride on the event, so you can tie a complaint to a kind of send.
Fields in data
- Common fields
- email_id, message_id, from, to, subject, status, tags, created_at.
- complaint_feedback_type
- The feedback type reported with the complaint.
- timestamp
- SES's time for the complaint.
- provider
- ses
- Rate pause
- Complaints over 24 hours are checked against 0.1% by default; above it, sending pauses.
"complaint_feedback_type": "abuse",
"provider": "ses"PostFrame, answered
What is in the email.complained payload?
The common fields (email_id, message_id, from, to, subject, status, tags, created_at) plus complaint_feedback_type, 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