New to VisionScaper?
Start here
Help Center › Get your API keys › Postmark webhook for bounces and complaints
Postmark webhook for bounces and complaints
Add the Postmark webhook address from VisionScaper's Marketing page and pick the four events.
When someone bounces, marks an email as spam, or unsubscribes, Postmark can tell your website. VisionScaper then stops mailing that person.
Before you start
- Postmark is set up (see “Get your Postmark Server API token”).
- A Broadcast stream exists.
Steps
- In WordPress open Settings → VisionScaper Marketing.
- Find the row Postmark webhook. It shows an address that ends with
/wp-json/dreamscaper/v1/mkt/postmark?k=and a long random key. Click the box and copy all of it, including the key afterk=. The key is VisionScaper’s own secret and is created automatically. - In Postmark open your server, then your Broadcast stream, then Webhooks, and add a webhook. That is the path VisionScaper’s page gives. The button text is not verified.
- Paste the address.
- Tick Delivery, Bounce, Spam Complaint and Subscription Change.
- Use Postmark’s verify option. Postmark says it tests the address for each enabled event and expects a 200 reply.
- Save.
What each event does
| Event | VisionScaper action |
|---|---|
| Delivery | Marks the send delivered |
| Bounce | Marks the contact’s email as bounced |
| Spam Complaint | Stops email to that contact |
| Subscription Change | Records an unsubscribe |
(Per the plugin’s description of the webhook handler. Exact status wording not verified.)
Tips
- Postmark does not sign webhooks. Its page suggests using a password in the URL, limiting by IP, and checking payloads. VisionScaper uses its secret key in the address, so keep the address private.
- Do not paste the address in public places. Anyone who has it can send fake events.
- Postmark also offers Open, Click, Inbound and other events. VisionScaper’s page asks only for the four above.
If something goes wrong
- Postmark says the webhook failed verification. The site is not public, or the address was cut off before the key.
- Unsubscribes do not register. The webhook was added to the wrong stream.
Sources
- Postmark, webhooks overview: https://postmarkapp.com/developer/webhooks/webhooks-overview (read 2026-10-15)
- Plugin: includes/marketing-admin.php; includes/marketing-public.php.