Invoice Update | Webhook Events - HoopAI Help Center

The InvoiceUpdate event fires whenever a field on an existing invoice is changed — including edits to line items, dates, discounts, or contact details. Use this event to keep external accounting or CRM systems in sync with the latest invoice state without polling the API.

Payload

Field	Type	Description
`_id`	`string`	Unique identifier for the invoice
`status`	`string`	Current invoice status after the update (e.g., `draft`, `sent`)
`liveMode`	`boolean`	`true` when the event originates from a live account; `false` in test mode
`amountPaid`	`number`	Total amount already paid against this invoice
`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 issued (`YYYY-MM-DD`)
`dueDate`	`string`	Payment due date (`YYYY-MM-DD`)
`discount`	`object`	Discount applied to the invoice (`type` and `value`)
`invoiceItems`	`array`	Updated line items on the invoice, each containing name, quantity, amount, currency, and taxes
`total`	`number`	Updated total invoice value
`title`	`string`	Display title shown on the invoice document (e.g., `"INVOICE"`)
`amountDue`	`number`	Updated remaining balance owed on the invoice
`createdAt`	`string`	ISO 8601 timestamp when the invoice was originally created
`updatedAt`	`string`	ISO 8601 timestamp of this update
`totalSummary`	`object`	Summary object containing updated `subTotal` and `discount` amounts

Example payload

{
  "_id": "6578278e879ad2646715ba9c",
  "status": "draft",
  "liveMode": false,
  "amountPaid": 0,
  "altId": "6578278e879ad2646715ba9c",
  "altType": "location",
  "name": "New Invoice",
  "invoiceNumber": "19",
  "currency": "USD",
  "issueDate": "2023-01-01",
  "dueDate": "2023-01-01",
  "discount": { "type": "percentage", "value": 10 },
  "invoiceItems": [
    {
      "taxes": [],
      "_id": "c6tZZU0rJBf30ZXx9Gli",
      "currency": "USD",
      "name": "Macbook Pro",
      "qty": 1,
      "amount": 999
    }
  ],
  "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
Invoice Sent — fires when an invoice is delivered to the contact
Invoices API — create, retrieve, and manage invoices programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related