Webhook event

`invoice.created`

A draft was created.

Type: invoice.created
The object it carries: the invoice object
Subscribe with: invoice.created, invoice.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

Example payload

{
  "id": "evt_0wma60e232e9te1z17yn07hh",
  "object": "event",
  "livemode": true,
  "created": "2026-10-08T09:00:00.000Z",
  "type": "invoice.created",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "inv_sxr44t9zk7krg104gmhsqx2p",
      "object": "invoice",
      "livemode": true,
      "created": "2026-10-08T09:00:00.000Z",
      "updated": "2026-10-08T09:00:00.000Z",
      "number": null,
      "status": "draft",
      "overdue": false,
      "customer": "cus_8ea07c40qsvv19f7rgmeb8ha",
      "order": null,
      "currency": "USD",
      "line_items": [
        {
          "name": "Wholesale beans, 20 kg",
          "quantity": 20,
          "unit_amount": "17.50",
          "amount": "350.00",
          "price": null
        }
      ],
      "subtotal": "350.00",
      "discount_amount": "0.00",
      "tax_amount": "0.00",
      "total": "350.00",
      "amount_paid": "0.00",
      "amount_due": "350.00",
      "due_date": "2026-10-22",
      "memo": "Thank you for your order.",
      "footer": "Acme Coffee Roasters LLC",
      "url": null,
      "pdf": null,
      "reminders": {
        "days_before_due": [
          3
        ],
        "days_after_due": [
          1,
          7
        ]
      },
      "finalized_at": null,
      "sent_at": null,
      "paid_at": null,
      "voided_at": null,
      "metadata": {}
    }
  },
  "request": {
    "id": "req_c454pdhvpfr55c7br4jvzqep",
    "idempotency_key": "a3f1c2de-7b0e-4a55-9d0c-2f6f1f0b8e11"
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in invoice.created
Field	In this example
`id`	`"inv_sxr44t9zk7krg104gmhsqx2p"`
`object`	`"invoice"`
`livemode`	`true`
`created`	`"2026-10-08T09:00:00.000Z"`
`updated`	`"2026-10-08T09:00:00.000Z"`
`number`	`null`
`status`	`"draft"`
`overdue`	`false`
`customer`	`"cus_8ea07c40qsvv19f7rgmeb8ha"`
`order`	`null`
`currency`	`"USD"`
`line_items`	A list of 1 item
`subtotal`	`"350.00"`
`discount_amount`	`"0.00"`
`tax_amount`	`"0.00"`
`total`	`"350.00"`
`amount_paid`	`"0.00"`
`amount_due`	`"350.00"`
`due_date`	`"2026-10-22"`
`memo`	`"Thank you for your order."`
`footer`	`"Acme Coffee Roasters LLC"`
`url`	`null`
`pdf`	`null`
`reminders`	An object with `days_before_due`, `days_after_due`
`finalized_at`	`null`
`sent_at`	`null`
`paid_at`	`null`
`voided_at`	`null`
`metadata`	An object with no fields

What each field means is on the page of the invoice object. This event carries no data.previous_attributes.

Endpoints behind it

Calls that change invoices. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.