Expenses
Webhook event
expense.deleted
Sent when an expense is deleted through the API or the app. The payload contains only the id of the deleted expense.
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 } · 3 attributes
eventstringAlways"expense.deleted"dataDeletedResourceIdentifies a resource that no longer exists.
idstring (uuid)e.g."d2b6f1a4-7c8e-4f90-a1b2-c3d4e5f6a7b8"
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.updatedSent when an expense is replaced or its file is swapped.
- Webhooks guideSubscribe, verify the signature, handle retries
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.
Get the business profile GET
Returns the business the token is scoped to. Companies include company_name and company_code; individual activities include first_name, last_name and individual_activity_id.