invoice.voided

Make sure to read the Webhooks Overview 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 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

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

APIs

REST API Endpoints

Usage

Webhooks

Purpose

Timing and delivery

Payload format

​Purpose

​Timing and delivery

​Payload format

Purpose

Timing and delivery

Payload format