Skip to main content

​
webhook_not_configured

HTTP Status: 400 Bad Request

​
Example response

{
  "error": {
    "code": "webhook_not_configured",
    "message": "Configure a webhook URL before using async validation. See https://docs.vatly.dev/webhooks",
    "docs_url": "https://docs.vatly.dev/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 Vatly 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