Webhooks setup
Webhooks notify your application when a Legal Entity, a document, a Tax Data Document, or a payment or rejection report changes. Use them for updates, then call the corresponding GET endpoint to read the latest resource.
Create a public HTTPS endpoint. For sandbox testing, you can use external service like: https://webhook.site, to receive and inspect test events.
1. Create a webhook
{
"event": "invoice.incoming",
"target": "https://your-domain.example/webhook",
"delivery": "webhook",
"authType": "header",
"authKey": "Authorization",
"authToken": "xxxxxxxxxxxxxxxxx"
}
2. Confirm the configuration
Response:
{
"uuid": "0199e8f6-5d4e-7f3a-9b2c-3d4e5f6a7b8c",
"event": "invoice.incoming",
"delivery": "webhook",
"target": "https://your-domain.example/webhook",
"authType": "header",
"authKey": "Authorization",
"authToken": "xxxxxxxxxxxxxxxxx",
"createdAt": "2026-11-01T10:00:00+00:00",
"updatedAt": "2026-11-01T10:00:00+00:00"
}
Or with a call to GET /event-destinations/{uuid} API endpoint.
3. Validate the received event
All the messages sent to your endpoint are sent with a POST request, like:
{
"eventId": "019a5c1f-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"eventType": "invoice.incoming",
"documentUuid": "0199e8a1-9c4d-7e5f-8a6b-7c8d9e0f1a2b",
"documentNumber": "2026-Invoice-0001",
"status": "received"
}
We manage to send the messages to your endpoints with a queue:
if your endpoint fails (we don't get a 200 response) then the webhook will retry 15 times every 300 seconds with a back-off rate of 1.25 for a total of about 10 hours.