# Webhooks

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


[Webhooks](https://en.wikipedia.org/wiki/Webhook) (or HTTP callbacks) can be used to notify your systems about events as they occur in your Chargebee instance. Using the Chargebee console, you can setup several webhook endpoints to be notified of such events.

## Data freshness[](#data-freshness)

A webhook payload is a point-in-time snapshot of the resource immediately after the change that generated the event, and the payload doesn't change on retries. The snapshot can be out of date by the time your application processes it, because they're delivered asynchronously and can arrive [out of order](https://www.chargebee.com/docs/billing/2.0/site-configuration/webhook_settings#out-of-order-delivery). To get the current state of the resource, call its retrieve endpoint.

## Webhook source IP addresses

Chargebee sends [webhook](/docs/api/webhook_endpoints/webhook-endpoint-object) events from specific IP addresses. If you receive webhooks, you may need to configure your integration to ensure that you only receive such notifications from the IP addresses listed below. Each region's list is also available in downloadable formats, making it easy to use in tasks such as configuring firewall rules, maintaining allowlists, and automating integrations.

**Notifications for Updates**

Any changes to our IP addresses are notified via the [API Changelog](https://www.chargebee.com/help/api-updates/). Alternatively, if you use a Google account, you can [turn on notifications](https://support.google.com/docs/answer/91588?co=GENIE.Platform%3DDesktop&hl=en) for the [Google Sheets version](https://docs.google.com/spreadsheets/d/1gEeGumNuCnJDDgdf5Bfq8o394xOzVmG-Ql66YOKEdgw/edit#gid=0) of these lists.

#### United States (US) Region

Webhooks for Chargebee sites hosted in the [US region](https://www.chargebee.com/docs/data-centers.html#the-united-states-us-data-center) originate from the following IP addresses:

-   [View in Google Sheets](https://docs.google.com/spreadsheets/d/1gEeGumNuCnJDDgdf5Bfq8o394xOzVmG-Ql66YOKEdgw/edit#gid=0)
-   [View as Plain Text](https://apidocs.chargebee.com/docs/api/webhooks/ips_us.txt)

#### European Union (EU) Region

Webhooks for Chargebee sites hosted in the [EU region](https://www.chargebee.com/docs/data-centers.html#the-european-union-eu-data-center) originate from the following IP addresses:

-   [View in Google Sheets](https://docs.google.com/spreadsheets/d/1gEeGumNuCnJDDgdf5Bfq8o394xOzVmG-Ql66YOKEdgw/edit#gid=1930470230)
-   [View as Plain Text](https://apidocs.chargebee.com/docs/api/webhooks/ips_eu.txt)

#### Australia (AU) Region

Webhooks for Chargebee sites hosted in the [AU region](https://www.chargebee.com/docs/2.0/data-centers.html#hosting-region-locations_australia-au-hosting-region) originate from the following IP addresses:

-   [View in Google Sheets](https://docs.google.com/spreadsheets/d/1gEeGumNuCnJDDgdf5Bfq8o394xOzVmG-Ql66YOKEdgw/edit#gid=2006061360)
-   [View as Plain Text](https://apidocs.chargebee.com/docs/api/webhooks/ips_au.txt)