Webhook events
The events AXOFFICE can send, how deliveries are signed, and how retries work.
| Event | Sent when |
|---|---|
invoice.created | A sales invoice is created |
invoice.paid | An invoice is paid in full |
payment.received | A customer payment is recorded |
customer.created | A customer is created |
bill.created | A supplier bill is created |
Verify the endpoint
- Add the endpoint in Settings › Integrations under webhooks, and choose its events.
- Choose Verify. AXOFFICE sends a challenge your endpoint must answer.
- For tools that can't answer a challenge, such as a Zapier catch hook, confirm the endpoint yourself instead.
Endpoints that haven't been verified receive nothing.
Check every delivery
Every delivery is signed with HMAC in the X-FinanceErp-Signature header, using your endpoint's secret. Check the signature before you trust what you receive.
Note
The header keeps its original name so that integrations already built against it keep working.
Expect repeats
Every event has a unique ID. Keep the IDs you've processed and skip any you've already seen — a retry can deliver the same event more than once.
Retries
- If your endpoint doesn't respond successfully, AXOFFICE tries again.
- An endpoint that keeps failing is switched off automatically, and administrators are alerted.
Was this page helpful?