Workflows
event_workflow_run_failure
The Workflow Run Failure event occurs when a run of a workflow fails.
Request
We send events to your webhook's URL with POST and a JSON body. Events are batched: a request can carry several events of this type. See Receiving Webhooks for batch sizes and retries, and Webhook Event Signatures to verify the request.
Headers
| Header | Description |
|---|---|
x-zinrelo-signature | The HMAC-SHA512 hex digest of <request body>:<nonce>, computed with the webhook's secret key. See Webhook Event Signatures. |
nonce | The Unix time, in milliseconds, at which the request was signed. It's part of the signed message. |
Payload
| Field | Type | Description |
|---|---|---|
request_id | string | A unique identifier of this webhook request. |
total_count | integer | The number of events in the batch (events). |
created_date | string | When the webhook request was created, as MM/DD/YYYY HH:MM:SS. |
events | array of object | The events in this batch. |
events[].id | string | The unique identifier of the event. Use it to detect events you already processed. |
events[].event_type | string | The type of event. One of event_workflow_run_failure. |
events[].data | object | The event's data. |
events[].data.workflow_run_info | object | A workflow run that failed. |
events[].data.workflow_run_info.workflow_id | string | The identifier of the workflow. |
events[].data.workflow_run_info.workflow_run_id | string | The identifier of the run that failed. |
events[].data.workflow_run_info.status | string | One of failed. |
events[].data.workflow_run_info.failed_at | string (date-time) | When the run failed, in UTC, in ISO 8601. |
events[].data.workflow_run_info.errors | array of object | The errors of the workflow's steps. |
events[].data.workflow_run_info.errors[].node_id (optional) | string | The identifier of the step that failed. |
events[].data.workflow_run_info.errors[].error (optional) | string | What went wrong. |
Example
{
"request_id": "6a0f2c1e4f8f0345970b6d96",
"total_count": 1,
"events": [
{
"id": "6a0f2c1e4f8f0345970b6d99",
"event_type": "event_workflow_run_failure",
"data": {
"workflow_run_info": {
"workflow_id": "wf_8d2a6c1e",
"workflow_run_id": "log_4b9e7f20",
"status": "failed",
"failed_at": "2026-07-17T12:00:00.123456+00:00",
"errors": [
{
"node_id": "node_3",
"error": "Member not found"
}
]
}
}
}
],
"created_date": "07/17/2026 12:00:05"
}Responses
| Status | Description |
|---|---|
200 | Acknowledges receipt of the events. Return 200 as soon as you receive the request and process the events afterwards, so the request doesn't time out. |
| Other | Any status code other than 200 is a failure: the request is sent again every 5 minutes until your endpoint returns 200 or the maximum number of attempts (5 by default) is reached. Your Customer Success Manager can change these settings. |