Invoices
Webhook event
invoice.deleted
Sent when a finalized invoice is deleted. The payload contains only the id of the deleted invoice.
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"invoice.deleted"dataDeletedResourceIdentifies a resource that no longer exists.
idstring (uuid)e.g."9c1e2d3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f"
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/invoices/{invoice}Fetch the current state of the invoice
- EVENTinvoice.createdSent when a finalized invoice is created, whether through the API, the app or a recurring invoice.
- EVENTinvoice.updatedSent when an invoice is replaced, when its payment status changes (including a Stripe payment), or after any other save.
- Webhooks guideSubscribe, verify the signature, handle retries
invoice.updated Webhook
Sent when an invoice is replaced, when its payment status changes (including a Stripe payment), or after any other save. 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.
List expenses GET
Returns the business's expenses, newest first, 50 per page. Use ?page= to paginate; the page size cannot be changed.