`PUT https://api.dropcontact.com/v1/enrich/webhook`

Set the URL that will receive the results of your requests. It applies to every request that has no `custom_callback_url` of its own.

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `callback_url` | string | yes |  |

## Responses

### 200 — Successful Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `success` | boolean | no | Whether the request was accepted. |
| `callback_url` | string | yes |  |

### 401 — Missing or invalid API key

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

### 403 — Unknown account

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

### 422 — Validation Error

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `detail` | array of ValidationError | no |  |
| `detail[].loc` | array of string \| integer | yes |  |
| `detail[].msg` | string | yes |  |
| `detail[].type` | string | yes |  |

### 429 — Too many requests, or temporary error on our side: try again in a few seconds

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

### 500 — Error on Dropcontact's side

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `detail` | string | yes |  |

See the [Webhooks](https://developer.dropcontact.com/en/webhooks/) guide to receive the results on your server.