Skip to main content

Receive Faire Webhook

POST 
/api/webhooks/faire

Single webhook endpoint that receives every Faire event. Faire identifies the event via the X-Faire-Webhook-Topic header — the request body shape varies by topic.

Authentication: none — Faire calls this endpoint directly. The X-Faire-Brand-Token header identifies the integration instance.

Required headers:

  • X-Faire-Webhook-Topic — one of ORDER_CREATED, ORDER_UPDATED, INVENTORY_QUANTITY_UPDATED (Faire also accepts X-Faire-Topic)
  • X-Faire-Brand-Token — brand token used to look up the integration instance

Supported topics:

  • ORDER_CREATED — new order placed; full order payload (default body shown here)
  • ORDER_UPDATED — order state change, shipments added, etc.
  • INVENTORY_QUANTITY_UPDATED — variant-level inventory update from Faire

Use the saved examples below to see each event's payload shape.

Request​

Responses​

Successful response