Expenses
Webhook event
expense.created
Sent when an expense is created through the API or the app.
2XXReturn any 2xx status to acknowledge the delivery. Any other status or a timeout schedules a retry.
- Attempt 1: Now
- Attempt 2: +10 s
- Attempt 3: +100 s
After 3 failures, the delivery is dropped. Deliveries can repeat and arrive out of order. Make your handler idempotent.
Lowercase hex HMAC-SHA256 of the raw request body, keyed with the webhook subscription's signing secret (whsec_…). Recompute it over the exact bytes received and compare with a constant-time function before trusting the payload. No timestamp or event-id header is sent.
Payload attributes
{ event, data } · 9 attributes
eventstringAlways"expense.created"dataExpenseidstring (uuid)e.g."d2b6f1a4-7c8e-4f90-a1b2-c3d4e5f6a7b8"datestring (date)nullablee.g."2026-03-04"Document date,
Y-m-d.totalnumbere.g.60.5Amount including VAT.
currencystringe.g."EUR"sellerstringe.g."Tiekėjas, UAB"created_atintegere.g.1772713800Unix timestamp, seconds.
updated_atintegere.g.1772713800Unix timestamp, seconds.
Related
- RetriesDeliveries can arrive more than once and out of order; make the handler idempotent.
- Verify the signatureCheck the
Signatureheader against the raw body before trusting the payload. - GET/expenses/{expense}Fetch the current state of the expense
- EVENTexpense.updatedSent when an expense is replaced or its file is swapped.
- EVENTexpense.deletedSent when an expense is deleted through the API or the app.
- Webhooks guideSubscribe, verify the signature, handle retries
Download the expense file GET
Streams the stored file under its original name. Content-Length is not sent.
expense.updated Webhook
Sent when an expense is replaced or its file is swapped. Each event is attempted up to 3 times: the first delivery, then retries after 10 s and 100 s; only a 2xx response counts as success. The request times out after 10 seconds.