Invoice Sent | Webhook Events - HoopAI Help Center

The InvoiceSent event fires each time an invoice is dispatched to the recipient contact, moving the invoice status to sent. Use this event to log delivery confirmations, start payment-reminder timers, or update CRM records to reflect that a client has been billed.

Payload

Field	Type	Description
`_id`	`string`	Unique identifier for the invoice
`status`	`string`	Invoice status at time of event — will be `"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
`businessDetails`	`object`	Sender business information (name, address, phone, website, logo URL)
`invoiceNumber`	`string`	Human-readable invoice number
`currency`	`string`	ISO 4217 currency code (e.g., `USD`)
`contactDetails`	`object`	Recipient contact information (id, email, name, company name)
`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`	Line items on the invoice, each containing name, quantity, amount, currency, and taxes
`total`	`number`	Total invoice value before payments
`title`	`string`	Display title shown on the invoice document (e.g., `"INVOICE"`)
`amountDue`	`number`	Remaining balance owed on the invoice
`createdAt`	`string`	ISO 8601 timestamp when the invoice was created
`updatedAt`	`string`	ISO 8601 timestamp of the most recent update
`totalSummary`	`object`	Summary object containing `subTotal` and `discount` amounts

Example payload

{
  "_id": "6578278e879ad2646715ba9c",
  "status": "sent",
  "liveMode": false,
  "amountPaid": 0,
  "altId": "6578278e879ad2646715ba9c",
  "altType": "location",
  "name": "New Invoice",
  "businessDetails": {
    "name": "ABC Corp.",
    "address": "9931 Beechwood, TX",
    "phoneNo": "+1-214-559-6993",
    "website": "wwww.example.com",
    "logoUrl": "https://example.com/logo.png"
  },
  "invoiceNumber": "19",
  "currency": "USD",
  "contactDetails": {
    "id": "6578278e879ad2646715ba9c",
    "email": "alex@example.com",
    "name": "Alex",
    "companyName": "ABC Corp."
  },
  "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 Paid — fires when the invoice is fully paid
Invoices API — create, retrieve, and manage invoices programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related