Webhooks
email.clicked
Sent when a recipient clicks a tracked link. PostFrame forwards the recipient first, then sends you the destination URL, the IP address and the user agent of the click.
What the event tells you
The link that was clicked
url is the original destination, not the tracking address.
The click, as received
ip and user_agent come from the request that followed the link, stored as sent.
Forged clicks record nothing
The redirect token is verified before the event is written, so a forged link sends you nothing.
Repeats are collapsed
A second click on the same URL within 60 seconds does not send another event.
Fields in data
- Common fields
- email_id, message_id, from, to, subject, status, tags, created_at.
- url
- The destination the recipient clicked through to.
- ip
- The IP address of the click.
- user_agent
- The raw browser string.
- tags
- The email's tags, for attribution.
"url": "<destination url>",
"ip": "<ip address>",
"user_agent": "<browser string>"PostFrame, answered
What is in the email.clicked payload?
The common fields (email_id, message_id, from, to, subject, status, tags, created_at) plus url, ip and user_agent.
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