Webhooks (Outbound)

Receive real-time notifications when things happen in FreeMaint

4 min read

FreeMaint can POST to your URL when events happen โ€” work order created, asset down, part low-stock, etc. Configure webhooks from /company-settings/webhooks. Available from Starter (capped 100/day).

Available events

  • WorkOrder.created, WorkOrder.statusChanged, WorkOrder.completed
  • Asset.created, Asset.statusChanged
  • Part.lowStock
  • Request.created, Request.statusChanged
  • PurchaseOrder.created, PurchaseOrder.received

Delivery

Webhooks POST to your URL with a JSON body and an X-Signature header (HMAC-SHA256 of the body using your webhook secret). Failed deliveries retry with exponential backoff up to 5 attempts.

Caps

  • Starter โ€” 100 deliveries/day per company
  • Business โ€” Unlimited
  • Enterprise โ€” Unlimited
  • Daily counter resets at 00:00 UTC

Tip

Verify the X-Signature header on every request to ensure the call came from FreeMaint and not a spoofer.

Was this page helpful?