Webhooks
Receive real-time events from Factory OS when production, quality, or machine state changes.
Webhooks are on the roadmap and not yet generally available. This page documents the intended design — expect changes before launch.
How it will work
You register an HTTPS URL in your organization settings. Factory OS POSTs a JSON payload to that URL whenever a subscribed event fires.
Planned event catalog
| Event | When it fires |
|---|---|
production_order.created | A new work order is opened |
production_order.completed | A work order is closed |
machine.state_changed | Machine transitions (running, idle, down) |
quality.defect_logged | A defect is recorded |
andon.called | An andon escalation is raised |
andon.resolved | An andon is cleared |
Signing
Payloads will be signed with HMAC-SHA256. Verify the X-Xentr-Signature header with your webhook secret before trusting the payload.
Retries
Failed deliveries (non-2xx response, timeout >10s) retry with exponential backoff up to 24 hours.
For now, poll the REST API or subscribe to Supabase realtime channels for live data.