API keys and webhooks
Build your own integrations with scoped API keys and signed webhooks.
API keys
- Create keys in Settings › Integrations › API keys.
- Live keys start with
fnerp_live_and test keys withfnerp_test_. - Each key has scopes that limit what it can do. Test keys can only read.
- Rotate or revoke a key at any time.
- A key is shown once, when you create it. Store it somewhere safe.
Webhooks
Webhooks tell your system the moment something happens in AXO.
- Add an endpoint address and choose the events.
- Verify it. AXO sends a challenge your endpoint must answer — or, for tools such as Zapier, you confirm it yourself.
- Once it's verified, AXO sends events as they happen.
- Every delivery is signed with HMAC in the
X-FinanceErp-Signatureheader. Check the signature before trusting what you receive. - Failed deliveries are retried. An endpoint that keeps failing is switched off automatically, and you're alerted.
- Endpoints that haven't been verified receive nothing.
Note
Requests sent again with the same idempotency key are processed only once, so retrying is safe.
Was this page helpful?
