The List webhook failures endpoint returns a paginated list of webhook delivery failures that require attention (for example, failures that are no longer being retried automatically).

Requirements: Base URL, Authentication, Error codes

Scope: tasks.webhooks.read

What this does

When you send a List webhook failures request,

• identify delivery gaps
• review failure reasons and retry attempts
• re trigger failed events when appropriate

Endpoint

GET /api/v4/tasks/webhook_failures

Query parameters

All query parameters are optional.

• limit
  The number of items to return. Default is 100. Maximum is 100.
• offset
  The number of items to skip before collecting results. Default is 0.
• created_at[gte]
  Return failures created on or after this timestamp (ISO 8601).
• created_at[lt]
  Return failures created before this timestamp (ISO 8601).

Related endpoints

• Get details for a failure: Get webhook failure
• Re trigger a failure: Retrigger webhook failure
• List configured webhooks: List webhooks

Example requests

Minimal request

curl -X GET "https://{cluster_id}.voiso.com/api/v4/tasks/webhook_failures" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Filter by date and time range

curl -X GET "https://{cluster_id}.voiso.com/api/v4/tasks/webhook_failures?created_at[gte]=2026-03-01T00:00:00Z&created_at[lt]=2026-04-01T00:00:00Z&limit=50&offset=0" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Response

If successful, the API returns a webhook_failures array and metadata.

{
  "webhook_failures": [
    {
      "id": "aabbccddeeff001122334455",
      "event": "call.ended",
      "status": "inactive",
      "reason": "Connection timeout",
      "webhook": {
        "id": "0b97ce11-b6e0-49b4-8f92-68040aa324bf",
        "name": "CRM call events"
      },
      "last_attempt_at": "2026-03-15T10:32:14Z",
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:32:14Z"
    }
  ],
  "metadata": {
    "total": 1
  }
}

Notes

• metadata.total is the total number of failures available for the request. The number returned in the current response is webhook_failures.length.
• Use Retrigger webhook failure to re trigger a failure after you have corrected the underlying delivery issue.

Troubleshooting

401 Unauthorized

Returned if the API key is missing or invalid.

403 Forbidden

Returned if the API key does not have access to Tasks resources.

422 Unprocessable Entity

Returned when one or more query parameter values are invalid (for example, an invalid timestamp format).

429 Too many requests

Returned if requests are rate limited.