Added
Webhooks in the BILL v3 API Postman collection
September 29th, 2025
Use BILL webhooks to subscribe to and receive real time notifications for events, such as create a vendor, update a bill, or create a payment. When you get the events catalog and create subscriptions, set the required header values based on the events you want to subscribe to.
| Event | Header values |
|---|---|
| Organization-level AP & AR events | devKey and sessionId |
| Partner-level AP & AR events | appKey and sessionId |
| Spend & Expense events | apiToken |
Idempotency key and notification URL for creating subscriptions
In your Create a subscription (POST /v3/spend/subscriptions) request, the X-Idempotent-Key header value must be in the UUID4 format. In addition, you can use an online service for generating a test notificationUrl value. For example, webhook.site.
Helpful links
- See BILL v3 API Postman collection to learn about working with the Postman collection.
- See Webhooks in the Guides section to learn about working with BILL Webhooks.