# Set the webhook that receives your account's alerts

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

`PUT https://platform.casafari.com/v1/claro/alerts/webhook`

[Claro AI](/docs/claro) · [REST API](/docs/claro#rest-api). Send `Authorization: Bearer $CASAFARI_API_KEY`: a platform API key or OAuth access token, metered in platform tokens; see [platform sign-in](/docs/rest#platform-api-keys) and [Claro AI](/docs/claro#keys). On the platform this is `PUT https://platform.casafari.com/v1/claro/alerts/webhook`; `PUT /v1/alerts/webhook` is Claro's own path, which the platform adds `/claro` to. The platform forwards the call to Claro unchanged: Claro's `Claro-Version` header and its error bodies (`{"error":{"code","message"}}`, with `rate_limited` and `quota_reached` on a 429) pass through.

Over MCP: no tool does this; it is REST only. See [MCP and REST compared](/docs/parity#claro-ai).

## Description

Claro's email alerts (new matches, price cuts of 3% or more, saved premises that left the market or came back, and the area pulse) are also sent to your own systems or AI assistant: after each digest Claro POSTs its items for your account as one JSON body, {id, type: "claro.alerts", created_at, items}, the same items as GET /v1/alerts/feed. One webhook per account; PUT replaces it and returns a new signing `secret`, shown once. Each delivery carries `Claro-Signature: t=<unix seconds>,v1=<hex>`, the HMAC-SHA256 of `<t>.<raw body>` under your secret: recompute it, compare in constant time and refuse a `t` more than 5 minutes old. Answer with any 2xx within 8 seconds. Anything else is retried with back-off (after 1 min, 5 min, 30 min, 2 h and 12 h) and dropped after the sixth try; `Claro-Delivery` is the same on every retry, so deduplicate on it. The URL must be https on a public host name (no IP address, port or credentials).

## Request body

Content type `application/json`. Required. Type: `object`.

- `url` (string (uri), required) at most 300 characters.

## Example request

Placeholders only: replace the token and the values with your own.

```bash
curl -X PUT "https://platform.casafari.com/v1/claro/alerts/webhook" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://hooks.example-customer.eu/claro"
}'
```

## Responses

### 200 The webhook and its secret (shown once)

No body.

Example from the API description:

```json
{
  "url": "https://hooks.example-customer.eu/claro",
  "secret": "whsec_Yq1x…"
}
```

### 400 Invalid request

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 401 Missing or invalid key

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 403 No access

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 429 Rate limited

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

## Related pages

- [Search commercial premises (POST /v1/search)](/docs/rest/claro/search-premises)
- [Refine a search (POST /v1/search/refine)](/docs/rest/claro/refine-search)
- [Get one premises (GET /v1/premises/{id})](/docs/rest/claro/get-premises)
- [Compare premises (POST /v1/compare)](/docs/rest/claro/compare-premises)
- [Claro AI: all its MCP tools and REST operations](/docs/claro)
- [Connect Claro to an MCP client](/docs/claro/connect)
- [MCP vs REST API compared](/docs/parity)
