---
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# New v3 API endpoints for webhooks

You can now use the BILL webhooks to subscribe to and receive real time notifications, for events, such as create a vendor, update a vendor, or create a payment.

> 🚧 BILL webhooks API is currently in BETA
>
> The BILL webhooks API is currently in BETA and is subject to improvements and changes. All improvements and changes will be documented.

When you subscribe to BILL events, you provide a location URL for where you want to receive notifications. BILL sends a notification to that URL each time a subscribed event is triggered.

> 📘 NOTE
>
> The base URL for the BILL webhook API is `https://gateway.stage.bill.com/connect-events`.

## Webhook operations

We have introduced a set of webhook API endpoints.

| Operation                                                                                           | API endpoint                                                    |
| :-------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------- |
| [Get events catalog](https://developer.bill.com/v3/reference/geteventcatalog)                       | `GET /v3/events/catalog`                                        |
| [Get list of event notifications](https://developer.bill.com/v3/reference/geteventsforsubscription) | `GET /v3/events/subscription/{subscriptionId}`                  |
| [Resend an event](https://developer.bill.com/v3/reference/resendevent)                              | `POST /v3/events/subscription/{subscriptionId}/event/{eventId}` |
| [Create a subscription](https://developer.bill.com/v3/reference/createsubscription)                 | `POST /v3/subscriptions`                                        |
| [Send a test subscription event](https://developer.bill.com/v3/reference/sendtestevent)             | `POST /v3/subscriptions/{subscriptionId}/test`                  |
| [Get subscription details](https://developer.bill.com/v3/reference/getsubscription)                 | `GET /v3/subscriptions/{subscriptionId}`                        |
| [Get list of subscriptions](https://developer.bill.com/v3/reference/getallsubscriptions)            | `GET /v3/subscriptions`                                         |
| [Update a subscription](https://developer.bill.com/v3/reference/updatesubscription)                 | `PATCH /v3/subscriptions/{subscriptionId}`                      |
| [Replace a subscription](https://developer.bill.com/v3/reference/replacesubscription)               | `PUT /v3/subscriptions/{subscriptionId}`                        |
| [Delete a subscription](https://developer.bill.com/v3/reference/deletesubscription)                 | `DELETE /v3/subscriptions/{subscriptionId}`                     |

The events catalog includes events for vendors, bills, and payments.

* `vendor.created`
* `vendor.updated`
* `vendor.archived`
* `vendor.restored`
* `bill.created`
* `bill.updated`
* `bill.archived`
* `bill.restored`
* `payment.updated`

See [Webhooks](https://developer.bill.com/v3/docs/webhooks) for more information.