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

# Invoice Sent | Webhook Events

> Fires when an invoice is sent to the contact.

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

```json theme={null}
{
  "_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 }
}
```

## Related

* [Invoice Create](/api-reference/webhooks/invoice-create) — fires when a new invoice is first created
* [Invoice Paid](/api-reference/webhooks/invoice-paid) — fires when the invoice is fully paid
* [Invoices API](/api-reference/invoices/overview) — create, retrieve, and manage invoices programmatically