Webhooks are notifications that allow your application to receive near real-time updates on events in the Tuum system. Instead of your app repeatedly polling the GET endpoint, webhooks enable Tuum to push event data directly to you.
At a high level, webhooks work as follows:
1
Create a webhook receiving endpoint
Create an HTTP URL on your server that accepts POST requests with JSON payloads.
2
Subscribe to webhooks
Subscribe to the events you care about, such as when a new person is activated or a payment is processed, and provide your webhook URL.
3
Receive and handle webhooks
When subscribed events occur, the service sends POST requests to your webhook URL for you to handle.
4
Manage webhook subscriptions
Update, pause, or remove webhook subscriptions as your needs change.
For details on each activity, see the following chapters in this section.
