Validate Webhook URL
**✅ Validate Webhook URL Format and Connectivity**
Validate a webhook URL for format compliance and test connectivity before configuration.
## 📋 **Request Body**
```json
{
"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**
```json
{
"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.
url
Webhook URL to validate
Response
URL validation completed
