Webhook event types
Subscribe to individual event types or a whole family such as event.*. A family subscription receives newly added types in that family. Resource restrictions limit which records trigger delivery.
The catalogue below is generated from the shared webhook contract. Expand a sample to see a synthetic payload for that exact occurrence.
Memberships membership.*
| Event type | Object | Sent when |
|---|---|---|
membership.purchased | membership_pass | When the pass is minted, immediately after payment is captured. Free memberships emit this too.Sample payload |
membership.refunded | membership_pass | When the pass moves to `refunded`. This is the signal to revoke whatever access the membership granted in your own system — Stello's copy stops being valid at the same moment.Sample payload |
Orders order.*
| Event type | Object | Sent when |
|---|---|---|
order.completed | order | When the order moves to `completed`, whichever way it was bought: in the app, at a card terminal, or through web checkout.Sample payload |
order.refunded | order | When the order moves to `refunded` or `partially_refunded`. Read `refunded_amount` rather than assuming the whole order went back.Sample payload |
Events event.*
| Event type | Object | Sent when |
|---|---|---|
event.published | event | When the event moves into `published` from any other status, including when a scheduled event publishes itself at its `publish_at` time.Sample payload |
event.updated | event | Whenever any field of the `event` object below actually changes value. Internal bookkeeping that is not part of the object never emits this, so a mirror can apply every one of these blindly.Sample payload |
event.canceled | event | When the event moves into `canceled`. `cancel_reason` carries the organiser’s note if they left one.Sample payload |
People person.*
| Event type | Object | Sent when |
|---|---|---|
person.email_changed | person | When a person changes the email on their Stello account, and only to organisations where they currently hold something: a membership that has not expired or been refunded, or a ticket to an event that has not ended. Match on `id`; `previous_email` is there for records you created before ids existed.Sample payload |
Test notifications
webhook.test checks your receiver and has no resource object. It is sent through the dashboard’s test action. Your handler should acknowledge it after verifying its signature.