Accounting/invoices/created

event accounting/invoices/created

Group: Accounting › Invoices · Operation ID: accounting_invoices_created

An invoice was issued. Carries the invoice id only; read the invoice for everything else.

Delivered once the invoice, its lines, its journal entry and any customer credit applied automatically have all settled, so the invoice is complete and readable when this arrives.

It fires however the invoice came about: a scheduled, manual or ad-hoc billing run, a create through the API, milestone invoicing, a credit-and-rebill, a subscription cancellation, or a load from an external system. A billing run issues many invoices and publishes one event for each, so expect bursts.

Invoices brought in by a one-time historical migration do not publish this event. They record invoices that were issued, sent and usually settled long ago in another system, so treating them as newly issued would trigger work that has already happened. Load that history from the invoicing read API instead.

If your own integration wrote the invoice, you will receive an event for it. Filter those out using the invoice's data source or its external identifier.

A delivery may be retried, so deduplicate on event.uuid, the id of the emission itself. Do not confuse it with event.data.id, which is the invoice: one invoice produces many emissions over its life.

Open in the interactive reference

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

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/created"`	yes	Public identifier of the event type.
`event.emittedAt`	string (date-time)	yes	When the event was emitted (ISO 8601).
`event.data`	accounting_invoices_createdPayload	yes
`event.data.id`	string	yes

Example:

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