Best Practices

Only subscribe to webhooks events that your application needs

This will help reduce the amount of webhook events that your server needs to process

Ensure that your event handlers are idempotent

Because our system processes events concurrently, duplicate events may occur. Each webhook event is sent with a unique id property, by storing these unique ID's your application can determine whether an event has already been processes.

Return a 2xx response promptly

Your server should respond with a 2xx status code to confirm the successful receipt of a webhook event. If it does not, Vagaro will continue retrying to send the webhook to your application. This may affect future webhook deliveries and Vagaro may deactivate your webhook subscription.

Handle events asynchronously

Delivery order of events is not guaranteed, we recommend to use the event payload's createdDate property, which indicates when the event occurred.