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.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Authentication: none — Faire calls this endpoint directly. The X-Faire-Brand-Token header identifies the integration instance.
Required headers:
X-Faire-Webhook-Topic— one ofORDER_CREATED,ORDER_UPDATED,INVENTORY_QUANTITY_UPDATED(Faire also acceptsX-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
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.