Skip to navigation

Validate Webhook URL

✅ Validate Webhook URL Format and Connectivity

Validate a webhook URL for format compliance and test connectivity before configuration.

📋 Request Body

{
"url": "https://your-domain.com/webhooks/headout/booking-status"
}

🔍 Validation Checks

Format Validation

  • ✅ HTTPS protocol requirement
  • ✅ Valid URL format
  • ✅ Length constraints (1-2048 characters)

Connectivity Test

  • ✅ HTTP HEAD request to endpoint
  • ✅ Response status check
  • ✅ 5-second timeout

📋 Response Format

{
"success": true,
"message": "URL validation completed",
"data": {
"url": "https://your-domain.com/webhooks/headout/booking-status",
"valid": true,
"accessible": true,
"connectivityError": null
},
"timestamp": "2024-01-15T10:30:00.000Z"
}

🎯 Use Cases

  • Pre-Configuration: Validate URL before creating webhook
  • Troubleshooting: Test webhook endpoint accessibility
  • Health Check: Verify webhook endpoint is responding
  • Development: Test webhook endpoints during development

📊 Response Codes

  • 200: Validation completed (check data.valid and data.accessible)
  • 400: Invalid request (missing URL)
  • 500: Internal server error

Authentication

AuthorizationBearer

JWT token from @etera-ai/auth package (auth.etera.dev) - Format: Bearer <token>

Request

This endpoint expects an object.
urlstringRequired
Webhook URL to validate

Response

URL validation completed