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.
Fields added to data
"url": "<destination url>",
"ip": "<ip address>",
"user_agent": "<browser string>"
Questions

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