Webhooks

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. In addition, as a BILL partner, when you create a subscription for events, you get event notifications for all your created organizations.

👍

Rely on GET API operations for accuracy with critical workflows

While the BILL webhooks work as expected, we recommend that webhook notifications should not be treated as the only source of truth. BILL sends webhook notifications for a select set of updates.

For critical workflows, we recommend validating data with the GET API operations for accuracy and consistency.

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.

In the next set of sections, we walk through the rules for working with BILL webhooks.

SectionDescription
Webhook API general rulesAccess rules, authentication rules, and idempotent key rules
Webhook API notification rulesBILL webhook notifications for events follow a set of rules
Work with BILL webhooksSubscribe to BILL events, generate a test event notification, and get events for a subscription
Test with BILL webhook securitySteps for validating the BILL webhook security measures
Webhook API error responsesFor error responses, BILL sends an HTTP status code depending on the error

In addition, we list examples of the BILL webhook events and notification payloads in the Notification payloads reference.

EventRelated documentation
bill.created
bill.updated
bill.archived
bill.restored
Bill notification payloads
vendor.created
vendor.updated
vendor.archived
vendor.restored
Vendor notification payloads
autopay.failedVendor auto-pay notification payloads
payment.updated
payment.failed
Payment notification payloads
bank-account.created
bank-account.updated
Bank account notification payloads
card-account.created
card-account.updated
Card account notification payloads
risk-verification.updatedRisk verification notification payloads
spend.transaction.updatedSpend & Expense transaction notification payloads