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.
Fields added to data
"complaint_feedback_type": "abuse",
"provider": "ses"
Questions

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