Webhooks

Receive real-time notifications when events occur in your Credits account.

Use cases

Get notified when an account's balance drops below a threshold
Track when credits are granted or deducted in real time
Sync credit events with your own billing or analytics system
Trigger actions when a reservation is confirmed or cancelled
Monitor plan assignments and changes

Available event types

Account creation and updates
Balance changes (grants, deductions)
Transaction completions
Reservation state changes (confirmed, cancelled, expired)
Plan assignments and removals
Usage records

Each event payload includes the full resource data so you can react without making additional API calls.

Setting up webhook endpoints

Create an HTTPS endpoint in your application that accepts POST requests
Register the endpoint URL in your Credits dashboard
Select which event types you want to receive
Verify the webhook signature on incoming requests to ensure authenticity

Webhooks are retried with exponential backoff if your endpoint returns a non-2xx status code.