> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesbricks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# invoice.voided

> [!TIP]
>
> Make sure to read the [Webhooks Overview](https://docs.salesbricks.com/api-reference/webhooks/overview.md) for important
> information about signature verification.

## Purpose

The `invoice.voided` webhook is triggered when an **Invoice** is voided, either in the Salesbricks app or through the public API.

Only voids a person makes send this event, not voids Salesbricks makes on its own, such as when an order is deleted.

Voiding is non-destructive: the invoice keeps its history, and its number until it is un-voided and reissued.

## Timing and delivery

* **One event per void.** If a void is reversed (for example, when a terminated subscription is reinstated) and the invoice is voided again, a new event is sent with the new `voided_at`, and the reissued invoice carries a new `invoice_number`.
* **Sent after the void completes.** Delivery is queued, not made inside the request that voided the invoice.
* **Not sent** for invoices migrated from another system before your cutover date, or for invoices on deleted or lost orders.

## Payload format

Your configured endpoint will receive an [Invoice](https://docs.salesbricks.com/api-reference/webhooks/invoice/payload.md) payload with `status` set to `VOIDED` and one extra field, `voided_at`, the time of the void as an ISO 8601 timestamp. Treat the invoice as cancelled: `remaining_amount` is left as it was before the void, so don't read it as a balance owed.

```json JSON theme={null}
{
  "event_type": "invoice.voided",
  "invoice": {
    "billed_company_id": "77fc9165-7eb4-4ded-9480-437864dcba64",
    "customer_id": "77fc9165-7eb4-4ded-9480-437864dcba64",
    "due_at": "2025-11-24T01:10:37.474930Z",
    "due_days": 30,
    "ends_at": "2025-11-24T23:59:59.999999Z",
    "id": "16eda8d7-7418-4aa1-bd07-41e6430688bc",
    "invoice_number": "16eda8d7-0",
    "is_partial_agreement": false,
    "num_days": 0,
    "order": {
      "accounts_payable_emails": [],
      "agreement_number": 1,
      "approval_status": "approved",
      "billing_schedule": "annually",
      "buyer": {
        "address": {
          "city": "Address City",
          "country": "Address Country",
          "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
          "line_1": "123 Address Line 1",
          "line_2": "Address Line 2 ",
          "region": "Address Region",
          "zip": "00000"
        },
        "external_id": null,
        "id": "77fc9165-7eb4-4ded-9480-437864dcba64",
        "is_partner": false,
        "name": "Example Co."
      },
      "chain_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "closed_at": "2025-10-24T01:15:37.474930Z",
      "created_at": "2025-10-24T01:10:37.474930Z",
      "crm_account_id": null,
      "crm_opportunity_id": null,
      "current_order_skus": [
        {
          "is_unlimited": false,
          "quantity": 1,
          "sku": {
            "code": "OrderBrickCode",
            "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
            "name": "OrderBrick"
          }
        }
      ],
      "ends_at": "2026-10-24T23:59:59.999+00:00",
      "grand_total": 100,
      "id": "c9b23aec-b7b7-4d2e-865d-71e4743ba828",
      "metadata": {
        "custom_field": "some value"
      },
      "order_type": "standard",
      "owner": null,
      "primary_user": {
        "company": {
          "address": {
            "city": "Address City",
            "country": "Address Country",
            "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
            "line_1": "123 Address Line 1",
            "line_2": "Address Line 2 ",
            "region": "Address Region",
            "zip": "00000"
          },
          "external_id": null,
          "id": "77fc9165-7eb4-4ded-9480-437864dcba64",
          "is_partner": false,
          "name": "Example Co."
        },
        "email": "buyername@buyer.com",
        "first_name": "BuyerFirstName",
        "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
        "last_name": "BuyerLastName"
      },
      "stage": "closed",
      "starts_at": "2025-10-25T00:00:00.000+00:00",
      "subscription_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "terminated_at": null,
      "updated_at": "2026-10-24T01:10:36.475320Z"
    },
    "paid_amount": 0,
    "paid_at": null,
    "payment_url": "https://app.salesbricks.com/invoice/16eda8d7-7418-4aa1-bd07-41e6430688bc/pay",
    "payments": [],
    "remaining_amount": 100,
    "starts_at": "2025-10-25T00:00:00Z",
    "status": "VOIDED",
    "voided_at": "2026-10-24T01:10:38.405401Z"
  },
  "webhook_run_id": "00000000-0000-0000-0000-000000000000"
}
```


## Related topics

- [Void an invoice](https://docs.salesbricks.com/api-reference/invoices/void-an-invoice.md)
- [Kintsugi](https://docs.salesbricks.com/integrations/kintsugi.md)
- [invoice.upcoming.due](https://docs.salesbricks.com/api-reference/webhooks/invoice/upcoming-due.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.