Invoice Void | Webhook Events - HoopAI Help Center

The InvoiceVoid event fires when an invoice is voided, rendering it uncollectible and removing it from outstanding balance calculations. Use this event to reverse accruals in accounting systems, cancel related automations, or notify contacts that a previously issued invoice has been cancelled.

Payload

Field	Type	Description
`_id`	`string`	Unique identifier for the invoice
`status`	`string`	Invoice status at time of event — will be `"void"`
`liveMode`	`boolean`	`true` when the event originates from a live account; `false` in test mode
`amountPaid`	`number`	Total amount paid before the invoice was voided
`altId`	`string`	Account (location) ID associated with the invoice
`altType`	`string`	Resource type for `altId` — always `"location"`
`name`	`string`	Internal name assigned to the invoice
`invoiceNumber`	`string`	Human-readable invoice number
`currency`	`string`	ISO 4217 currency code (e.g., `USD`)
`issueDate`	`string`	Date the invoice was originally issued (`YYYY-MM-DD`)
`dueDate`	`string`	Original payment due date (`YYYY-MM-DD`)
`total`	`number`	Total invoice value at the time of voiding
`title`	`string`	Display title shown on the invoice document (e.g., `"INVOICE"`)
`amountDue`	`number`	Balance that was outstanding when the invoice was voided
`createdAt`	`string`	ISO 8601 timestamp when the invoice was created
`updatedAt`	`string`	ISO 8601 timestamp of the most recent update (the void action)
`totalSummary`	`object`	Summary object containing `subTotal` and `discount` amounts

Example payload

{
  "_id": "6578278e879ad2646715ba9c",
  "status": "void",
  "liveMode": false,
  "amountPaid": 0,
  "altId": "6578278e879ad2646715ba9c",
  "altType": "location",
  "name": "New Invoice",
  "invoiceNumber": "19",
  "currency": "USD",
  "issueDate": "2023-01-01",
  "dueDate": "2023-01-01",
  "total": 999,
  "title": "INVOICE",
  "amountDue": 999,
  "createdAt": "2023-12-12T09:27:42.355Z",
  "updatedAt": "2023-12-12T09:27:42.355Z",
  "totalSummary": { "subTotal": 999, "discount": 0 }
}

Invoice Create — fires when a new invoice is first created
Invoices API — create, retrieve, and manage invoices programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related