API ReferenceWebhooks
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.
In: header
Path Parameters
id*string
Webhook endpoint ID
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.iozen.ai/api/v1/webhooks/cm7abc12x0001yz9k8mno3pqr"{
"success": true,
"data": {
"webhook": {
"id": "cm7wh01a0001yz9k8mno3pqr",
"url": "https://api.example.com/webhooks/iozen",
"events": [
"submission.completed",
"submission.updated"
],
"status": "active",
"description": "Production submission handler",
"last_delivery_at": "2026-02-24T16:30:00.000Z",
"last_delivery_ok": true,
"consecutive_fails": 0,
"created_at": "2026-02-01T09:00:00.000Z",
"updated_at": "2026-02-24T16:30:00.000Z"
}
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "Validation failed",
"details": {}
}
}{
"success": false,
"error": {
"code": "authentication_required",
"message": "Missing or invalid API key",
"details": {}
}
}{
"success": false,
"error": {
"code": "insufficient_scopes",
"message": "API key lacks required scopes for this endpoint",
"details": {}
}
}{
"success": false,
"error": {
"code": "resource_not_found",
"message": "Resource not found",
"details": {}
}
}{
"success": false,
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"details": {}
}
}{
"success": false,
"error": {
"code": "internal_error",
"message": "An internal error occurred",
"details": {}
}
}