Webhook Guide

Webhooks let Popup send updates to another tool automatically. You choose what updates to send, where to send them, and how to keep them secure.

What is a webhook?

A webhook is a message Popup sends when something happens, like a sale, a registration, or a new subscriber. Instead of checking manually, your other tools get updated instantly.

Before you start

- Have a destination URL from the app or service that should receive updates.

- Decide which events you care about (for example: orders, leads, registrations).

- Choose how you want to secure requests: signed secret or bearer token.

How to set it up

1. Open your venue dashboard, then go to Settings and Webhooks.

2. Click Add endpoint.

3. Paste your destination URL.

4. Pick the events you want this endpoint to receive.

5. Choose an authentication mode.

6. Click Create and copy the generated secret or token right away.

7. Use Send test to confirm your setup works.

Authentication options

Signed secret (recommended)

Popup sends a signature with every request. Your receiving app checks the signature and accepts only real requests from Popup.

Bearer token

Popup sends a token with every request. Your receiving app compares it with the token you saved. You can paste your own token or let Popup generate one for you.

What data is sent?

Every event includes a simple envelope with:

- An event ID (unique per event)

- An event type (what happened)

- A timestamp (when it happened)

- The event details (the actual payload)

If you want a different shape, you can choose a custom payload format in endpoint settings.

Testing and troubleshooting

- Use Send test to trigger a sample event.

- Open View delivery history to see success and failure status.

- If requests fail, verify URL, authentication, and endpoint availability.

- If needed, rotate your secret and update it in your receiving app.

Best practices

- Keep secrets and tokens private.

- Store them in your server environment, not in frontend code.

- Copy and save generated credentials immediately.

- Use one endpoint per workflow if you want cleaner tracking.

‍