Overview

Intro to Webhooks

Webhooks allow Wristband to notify your application when specific events occur, such as when a user is created, updated, or deleted.

When an event occurs, Wristband sends an HTTP POST request containing the event details to a webhook endpoint configured in your application (e.g., https://yourapp.com/webhooks/wristband) Your application can then process the event and perform any necessary actions.

Event Types

Every webhook event has an associated event type, such as v1.user.created, that identifies the event being reported.

The event type determines two things:

1. Event Trigger: The action or change that causes the event to be generated. For example, v1.user.created is triggered when a new user is created in your Wristband application.
2. Payload Structure: The structure of the data included in the webhook payload. Events of the same type follow a consistent payload structure, allowing your application to process them predictably.

Event Catalog

For a complete list of supported webhook event types and their payload structures, refer to the Wristband Event Catalog.