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

# webhook_not_configured

> Error: No webhook URL configured

# webhook\_not\_configured

<Info>HTTP Status: **400 Bad Request**</Info>

## Example response

```json theme={null}
{
  "error": {
    "code": "webhook_not_configured",
    "message": "Configure a webhook URL before using async validation. See https://docs.avatcado.com/webhooks",
    "docs_url": "https://docs.avatcado.com/errors/webhook_not_configured"
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

## What happened?

You called an async validation endpoint but your account does not have a webhook URL configured, or the webhook is disabled. Async validation delivers results via webhook, so a URL must be configured before use.

## How to fix

1. **Configure a webhook URL via the API**: `PUT /v1/webhooks/config` with `{"url": "https://your-app.com/webhooks"}`
2. **Or configure it in the Avatcado dashboard** under Settings > Webhooks
3. Make sure the webhook is enabled (not disabled)

## Common mistakes

* **Disabling the webhook and forgetting to re-enable it**: If you disabled your webhook for testing, remember to re-enable it before using async validation
* **Using HTTP instead of HTTPS**: Webhook URLs must use HTTPS for security. HTTP URLs are rejected during configuration

## Related errors

* [`tier_insufficient`](/errors/tier_insufficient): Async validation requires Pro or Business tier
* [`invalid_vat_format`](/errors/invalid_vat_format): Invalid VAT numbers are rejected immediately (not queued)