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, Voiso returns webhook failure records so you can:

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.

200OK

400Bad Request

401Unauthorized

403Forbidden

429Too many requests