An invoice was issued.

Group: Accounting › Invoices

Open in the interactive reference

Event accounting/invoices/created, delivered as a POST to the webhook endpoint of a subscription to it.

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, an import with POST accounting/invoices/import, milestone invoicing, a credit-and-rebill, a subscription cancellation, or a load from an external system. A billing run issues many invoices and sends 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.

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 date-time yes When the event was emitted (ISO 8601).
event.data accounting_invoices_createdPayload yes
event.data.id string yes
{
  "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"
    }
  }
}