Skip to main content

error-handling

Webhook Error Handling​

Webhook Configuration Errors​

ErrorSolution
400 Invalid URLEnsure URL is valid and uses http:// or https://
401 UnauthorizedCheck your access token is valid and not expired
404 Not FoundNo webhook subscription exists - create one first

Example Error Response​

{
  "message": "Invalid webhook URL",
  "status": 400,
  "validationErrors": [
    {
      "field": "webhookUrl",
      "message": "URL must be a valid HTTP or HTTPS URL"
    }
  ]
}