# Events

Webhook event payloads delivered to your subscription URLs.

## Order created event

 - [POST order-created](https://tote.redocly.app/online-ordering/spec/openapi/events/ordercreatedevent.md): Sent when a new order is placed via checkout. Contains minimal
order data -- fetch the full order via GET /orders/{order_id}.

## Order status changed event

 - [POST order-status-changed](https://tote.redocly.app/online-ordering/spec/openapi/events/orderstatuschangedevent.md): Sent when any of the order's three status fields change (lifecycle
status, fulfillment status, or payment status). Includes previous
and current values for all three fields.

## Order cancelled event

 - [POST order-cancelled](https://tote.redocly.app/online-ordering/spec/openapi/events/ordercancelledevent.md): Sent when an order is cancelled. Includes cancellation reason
if provided. Any pending payments are voided and completed
payments are refunded.

## Stock updated event

 - [POST stock-updated](https://tote.redocly.app/online-ordering/spec/openapi/events/stockupdatedevent.md): Sent when item availability changes at a location. A single event
can contain multiple items. Use GET /locations/{location_id}/inventory
as a polling fallback.

## Menu changed event

 - [POST menu-changed](https://tote.redocly.app/online-ordering/spec/openapi/events/menuchangedevent.md): Sent when a location's menu is modified. Re-fetch the full menu
via GET /locations/{location_id}/menu. Use version_hash to
avoid unnecessary re-fetches.

## Location hours changed event

 - [POST location-hours-changed](https://tote.redocly.app/online-ordering/spec/openapi/events/locationhourschangedevent.md): Sent when a location's business hours are modified. Includes both
previous and current hours for comparison.