Skip to main content
Fire notifies your system of changes in real time via webhooks — HTTP POST requests sent to your registered endpoint whenever something relevant happens. You subscribe to the events you care about and act on them however your integration requires.

​
Channel events

Channel events notify your system when the sales channel catalog changes. Use them to keep your local channel mapping in sync — channel IDs are required when injecting orders and when processing publication events.

channel.updated

A channel was created or its configuration changed.

channel.deleted

A channel was removed from Fire.

channels.sync

Bulk sync — full channel catalog in batches of up to 50.

​
Store events

Store events notify your system when store configurations change. Fire supports single-store updates, explicit deletions, and bulk syncs for onboarding or mass changes.

store.updated

A store was created or its configuration changed.

store.deleted

A store was removed from Fire.

stores.sync

Bulk sync — up to 50 stores per batch.
Menu events carry the full catalog definition for a specific store and channel — categories, products, modifier groups, and schedules. The payload is ready to be forwarded to downstream systems.

menu.updated

A menu was created or updated. Also used to signal menu removal (empty payload).

menus.sync

Bulk sync — menus for multiple stores in batches of up to 50.

​
Product events

product.updated

One or more products were updated across all stores where they appear.

product.availability_changed

A product was activated or deactivated in one or more stores.

​
Order events

order.status_changed

An order’s status changed inside Fire.

​
Event envelope

All events share the same top-level structure: 
{
  "event": {
    "id": "evt_abc123",
    "type": "event.type",
    "createdAt": "2025-01-15T14:30:00Z",
    "timezone": "America/Guayaquil"
  },
  "data": {}
}
FieldTypeDescription
eventobjectEvent metadata
event.idstringUnique event ID — use for deduplication
event.typestringEvent type identifier
event.createdAtstringISO 8601 timestamp when the event was emitted
event.timezonestringTimezone of the originating account
dataobjectEvent-specific payload

​
Request headers

HeaderDescription
Content-Typeapplication/json
X-Fire-EventEvent type (e.g. menu.updated)
X-Fire-SignatureHMAC-SHA256 signature — see Authentication
X-Fire-DeliveryUnique delivery attempt ID

​
Deduplication

Use the event.id field to detect and discard duplicate deliveries. Fire may deliver the same event more than once in case of retries.

​
Responding

Return any 2xx within 10 seconds to acknowledge receipt. Process asynchronously to avoid timeouts.