> ## Documentation Index
> Fetch the complete documentation index at: https://docs.curbwaste.com/llms.txt
> Use this file to discover all available pages before exploring further.

# location.updated

> Outbound webhook delivered after a location write that mutates data.

CurbWaste `POST`s this envelope to your registered HTTPS URL after a location PATCH, reactivate, or other write that mutates the location (including PO fill-in on reuse when data changes). Authenticate with HMAC (`X-CurbWaste-Signature`), not a Bearer API key.

## Headers

| Header | Example |
| - | - |
| `Content-Type` | `application/json` |
| `X-CurbWaste-Signature` | `t=<unix>,s=<hex>` |
| `X-CurbWaste-Event-Id` | `evt_…` (same as body `id`) |
| `X-CurbWaste-Event-Type` | `location.updated` |

## Body

```json theme={null}
{
  "id": "evt_bbbbbbbb-cccc-dddd-eeee-ffffffffffff",
  "type": "location.updated",
  "createdAt": "2026-09-16T18:10:00.000Z",
  "data": {
    "id": "11111111-2222-3333-4444-555555555555",
    "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Main Yard",
    "status": "ACTIVE",
    "locationNote": "Gate code 1234",
    "purchaseOrderNumber": "PO-99",
    "address": {
      "address": "123 Main St",
      "city": "Austin",
      "state": "TX",
      "zipcode": "78701",
      "streetNo": "123",
      "county": null,
      "borough": null,
      "geoPlaceId": null,
      "latitude": 30.2672,
      "longitude": -97.7431
    },
    "createdAt": "2026-09-16T18:00:00.000Z",
    "updatedAt": "2026-09-16T18:10:00.000Z"
  }
}
```

`data` is the full location profile after the write. Respond `2xx` quickly; retries use envelope `id` for idempotency.

See [Webhook setup](/guides/webhooks-setup) to verify signatures.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.