Webhooks
Get an HTTPS POST when something happens, and verify that it came from us.
Adding an endpoint
In Studio, open Webhooks, give us an HTTPS URL and tick the events you care about. Venued POSTs a JSON body to that URL whenever one of them happens. Connect it to your own backend, or to something like Zapier or Make.
An API key can do the same thing without Studio: POST/v1/webhooks adds an endpoint, GET/v1/webhooks shows the ones you have, and DELETE/v1/webhooks/{webhookId} removes one.
The events you can subscribe to
order.confirmedfires when an order is paid and confirmed.event.publishedfires when one of your events becomes visible.
Verifying the signature
Every delivery carries a Venued-Signatureheader. Recompute an HMAC-SHA256 over the timestamp and the raw body using your endpoint’s signing secret, then compare it against the v1 value in that header. If it does not match, discard the request.
The signing secret is shown beside the endpoint in Studio.
Acknowledging, and what happens if you do not
Return any 2xx status to acknowledge a delivery. Anything else is treated as a failure and retried with backoff.
When something breaks
Each endpoint in Studio keeps a delivery log: the event, the HTTP status we got back, how many attempts it took, how long it took, and the exact body we sent. Open a delivery to read the payload, and send it again once your endpoint is fixed.
A disabled endpoint will not accept a resend. Enable it first.