Expenses
Webhook event
expense.updated
Sent when an expense is replaced or its file is swapped.
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.updated"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.createdSent when an expense is created through the API or the app.
- EVENTexpense.deletedSent when an expense is deleted through the API or the app.
- Webhooks guideSubscribe, verify the signature, handle retries
expense.created Webhook
Sent when an expense is created through the API or the app. 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.
expense.deleted Webhook
Sent when an expense is deleted through the API or the app. The payload contains only the id of the deleted expense. 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.