---
updatedAt: 2026-03-16T17:32:13.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# Notification payloads reference

When you subscribe to a BILL event and the event triggers, BILL sends a notification to your provided `notificationUrl`.

In this section, we walk through the notification payloads available for different BILL events.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Event
      </th>

      <th>
        Related documentation
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `vendor.created`<br />
        `vendor.updated`<br />
        `vendor.archived`<br />
        `vendor.restored`
      </td>

      <td>
        <Anchor label="Vendor notification payloads" target="_blank" href="doc:vendor-webhook-notification-payloads">Vendor notification payloads</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `autopay.failed`
      </td>

      <td>
        <Anchor label="Vendor auto-pay notification payload" target="_blank" href="doc:vendor-autopay-webhook-notification-payloads">Vendor auto-pay notification payload</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `bill.created`<br />
        `bill.updated`<br />
        `bill.archived`<br />
        `bill.restored`
      </td>

      <td>
        <Anchor label="AP bill notification payloads" target="_blank" href="doc:bill-webhook-notification-payloads">AP bill notification payloads</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `payment.updated`<br />
        `payment.failed`
      </td>

      <td>
        <Anchor label="AP payment notification payloads" target="_blank" href="doc:payment-webhook-notification-payloads">AP payment notification payloads</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `bank-account.created`<br />
        `bank-account.updated`
      </td>

      <td>
        <Anchor label="Bank account notification payloads" target="_blank" href="doc:bank-account-webhook-notification-payloads">Bank account notification payloads</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `card-account.created`<br />
        `card-account.updated`
      </td>

      <td>
        <Anchor label="Card account notification payloads" target="_blank" href="doc:card-account-webhook-notification-payloads">Card account notification payloads</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `invoice.created`<br />
        `invoice.updated`<br />
        `invoice.archived`<br />
        `invoice.restored`
      </td>

      <td>
        <Anchor label="AR invoice notification payloads" target="_blank" href="doc:invoice-webhook-notification-payloads">AR invoice notification payloads</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `risk-verification.updated`
      </td>

      <td>
        <Anchor label="Risk verification notification payload" target="_blank" href="doc:risk-verification-webhook-notification-payloads">Risk verification notification payload</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `spend.transaction.updated`
      </td>

      <td>
        <Anchor label="Spend & Expense transaction notification payload" target="_blank" href="doc:spend-expense-transaction-notification-payloads">Spend & Expense transaction notification payload</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `spend.reimbursement.created`<br />
        `spend.reimbursement.updated`<br />
        `spend.reimbursement.deleted`
      </td>

      <td>
        <Anchor label="Spend & Expense reimbursement notification payload" target="_blank" href="doc:spend-expense-reimbursement-notification-payload">Spend & Expense reimbursement notification payload</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        `spend.three-ds-challenge.created`
      </td>

      <td>
        <Anchor label="Spend & Expense 3D Secure challenge notification payload" target="_blank" href="doc:spend-expense-3ds-challenge-notification-payload">Spend & Expense 3D Secure challenge notification payload</Anchor>
      </td>
    </tr>
  </tbody>
</Table>