Accounting/invoices/updated

event accounting/invoices/updated

Group: Accounting › Invoices · Operation ID: accounting_invoices_updated

An invoice changed after it was issued. Carries the invoice id only; re-read the invoice for its new state.

Delivered whenever something about the invoice changes after it is issued: an edit to its header or lines, a payment applied to it, a credit memo applied to it, the invoice being emailed, delivered, failed or opened, and a chargeback dispute opening or resolving.

This is a change notification rather than a description of the change. The payload names the invoice but not what changed about it, and there is no before-and-after, so re-read the invoice and take its current amounts and status from there. A subscriber that needs a diff keeps its own last-known copy, because the delivery cannot supply one.

There are deliberately no separate events for payment, credit, delivery or dispute. To tell those apart, compare what you read against your last-known copy: the invoice's status, amount due, delivery status and dispute state are all readable. More specific events can be added later without breaking this one.

Several changes in quick succession are several deliveries, and a re-read after the first may already show the last. Deduplicate on event.uuid, the id of the emission itself, and do that before anything with a financial side effect. Take balances from a read rather than from adding up events.

Invoices touched by a one-time historical migration do not publish this event, the same as accounting/invoices/created.

Open in the interactive reference

Delivered as POST to the webhook endpoint of a subscription to accounting/invoices/updated.

Payload

Required, application/json: object.

Field	Type	Required	Description
`subscription`	object	yes	The subscription this delivery was made for.
`subscription.uuid`	string	yes	Stable identifier of the subscription.
`subscription.type`	string	yes	Transport the subscription delivers through; `webhook` for deliveries carried by this request.
`subscription.name`	string	yes	Authored name of the subscription.
`event`	object	yes	The emitted event being delivered.
`event.uuid`	string	yes	Stable identifier of this emission — the idempotency key for a receiver, since a delivery may be retried.
`event.identifier`	`"accounting/invoices/updated"`	yes	Public identifier of the event type.
`event.emittedAt`	string (date-time)	yes	When the event was emitted (ISO 8601).
`event.data`	accounting_invoices_updatedPayload	yes
`event.data.id`	string	yes

Example:

{
  "subscription": {
    "uuid": "<uuid>",
    "type": "<type>",
    "name": "<name>"
  },
  "event": {
    "uuid": "<uuid>",
    "identifier": "accounting/invoices/updated",
    "emittedAt": "2026-01-15T09:30:00.000Z",
    "data": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  }
}