Invoices events

Outbound webhook events for invoices: when each one fires and the exact JSON payload Centerfy POSTs to your URL.

4 events. Subscribe to them in Settings → API & Webhooks → Webhooks or with the outbound webhook subscription endpoints. Delivery, authentication headers and the common envelope are described in the webhooks overview.

Event	When it fires
`invoice.created`	A new invoice is created — including invoices created from a payment link.
`invoice.sent`	An invoice is emailed to its contact.
`invoice.paid`	An invoice is paid — online or marked paid manually.
`invoice.voided`	An invoice is voided or cancelled.

invoice.created

Invoice created. A new invoice is created — including invoices created from a payment link.

{
  "event": "invoice.created",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "invoice": {
    "id": "<uuid>",
    "invoice_number": "INV-0042",
    "contact_id": "<uuid>",
    "quote_id": null,
    "amount": 499,
    "status": "pending",
    "issued_at": "2026-06-20T14:00:00.000Z",
    "due_date": "2026-07-04",
    "paid_at": null,
    "payment_method": null,
    "payment_url": "https://pay.example.com/inv_42",
    "items": [
      {
        "item": "Setup",
        "quantity": 1,
        "amount": 499
      }
    ],
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}

invoice.sent

Invoice sent. An invoice is emailed to its contact.

{
  "event": "invoice.sent",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "invoice": {
    "id": "<uuid>",
    "invoice_number": "INV-0042",
    "contact_id": "<uuid>",
    "quote_id": null,
    "amount": 499,
    "status": "pending",
    "issued_at": "2026-06-20T14:00:00.000Z",
    "due_date": "2026-07-04",
    "paid_at": null,
    "payment_method": null,
    "payment_url": "https://pay.example.com/inv_42",
    "items": [
      {
        "item": "Setup",
        "quantity": 1,
        "amount": 499
      }
    ],
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}

invoice.paid

Invoice paid. An invoice is paid — online or marked paid manually.

{
  "event": "invoice.paid",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "invoice": {
    "id": "<uuid>",
    "invoice_number": "INV-0042",
    "contact_id": "<uuid>",
    "quote_id": null,
    "amount": 499,
    "status": "paid",
    "issued_at": "2026-06-20T14:00:00.000Z",
    "due_date": "2026-07-04",
    "paid_at": "2026-06-21T09:00:00.000Z",
    "payment_method": "card",
    "payment_url": "https://pay.example.com/inv_42",
    "items": [
      {
        "item": "Setup",
        "quantity": 1,
        "amount": 499
      }
    ],
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}

invoice.voided

Invoice voided. An invoice is voided or cancelled.

{
  "event": "invoice.voided",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "invoice": {
    "id": "<uuid>",
    "invoice_number": "INV-0042",
    "contact_id": "<uuid>",
    "quote_id": null,
    "amount": 499,
    "status": "void",
    "issued_at": "2026-06-20T14:00:00.000Z",
    "due_date": "2026-07-04",
    "paid_at": null,
    "payment_method": null,
    "payment_url": "https://pay.example.com/inv_42",
    "items": [
      {
        "item": "Setup",
        "quantity": 1,
        "amount": 499
      }
    ],
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}