ioZen Docs
GET
/webhooks

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.

In: header

Query Parameters

limit?integer

Maximum number of items to return (1–100, default 50)

cursor?string

Cursor for pagination — use next_cursor from a previous response

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"
{
  "success": true,
  "data": {
    "webhooks": [
      {
        "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"
      }
    ],
    "pagination": {
      "has_more": false,
      "next_cursor": null
    }
  }
}
{
  "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": {}
  }
}