Webhooks and events

Receive Wingspan events as they happen, verify every webhook push, and recover missed events from the 30-day event log.

If you use V1 webhooks, start with the overview to learn how V3 subscriptions, signed event references, and the event log differ.

Read these pages in order:

1. Overview: learn how webhook push and the event log work together, what an event contains, and how scopes determine which events you receive.
2. Create a subscription: create, update, pause, or delete a subscription, then rotate its signing secret.
3. Verify signatures: verify Wingspan-Signature with Node.js or Python.
4. Delivery and retries: understand the retry schedule, success criteria, delivery diagnostics, and reliable-consumer checklist.
5. Recover missed events: read the event log with a saved cursor and resynchronize after a cursor expires.
6. Event types: find every currently subscribable event, grouped by resource.
7. Paid vs DepositConfirmed: choose the payment event that fits your reconciliation workflow and understand each event's limits.