​

webhook_not_configured

​

Example response

{
  "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?

​

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: Async validation requires Pro or Business tier
• invalid_vat_format: Invalid VAT numbers are rejected immediately (not queued)