# 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](https://docs.api.lensing.ai/?op=accounting_invoices_created)

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:

```json
{
  "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"
    }
  }
}
```
