> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Match webhooks for addresses and businesses to customers

Updated address and business notifications make it easier to work with addresses and businesses for a customer in the API.

---

## What's new?

We updated the [address](https://developer.paddle.com/api-reference/addresses/overview.md) and [business](https://developer.paddle.com/api-reference/businesses/overview.md) entities in the Paddle API and webhooks so that they include the related `customer_id`.

## How it works

Customers in Paddle are modular. Each customer entity can be related to one or more address and business entities. Addresses and businesses are subentities, meaning you need the Paddle ID for a customer to work with an address or business in the API. For example, to [update an address for a customer](https://developer.paddle.com/api-reference/addresses/update-address.md) you need both the Paddle ID for the customer entity and the address entity:

{% api-endpoint method="PATCH" path="/customers/{customer_id}/addresses/{address_id}"  %}

- **customer_id** (string): Unique Paddle ID for this customer entity, prefixed with `ctm_`
- **address_id** (string): Unique Paddle ID for this address entity, prefixed with `add_`.
{% /api-endpoint %}

When you [receive a webhook](https://developer.paddle.com/webhooks/overview.md) for an address or business event, the data payload mirrors the entity in the Paddle API. Since it doesn't include the Paddle ID of the related customer, previously you couldn't immediately work with the address or business in the API. You'd need to store the Paddle ID of the customer for an address on your side.

With this update, we added `customer_id` to [address](https://developer.paddle.com/api-reference/addresses/overview.md) and [business](https://developer.paddle.com/api-reference/businesses/overview.md) entities in the Paddle API and webhooks. Webhooks for addresses and businesses now include all the information you need to work with them in the Paddle API.

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `address.customer_id` | Field | added | Address |  |
| `business.customer_id` | Field | added | Business |  |