Home
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

HeaderDescription
x-zinrelo-signatureThe HMAC-SHA512 hex digest of <request body>:<nonce>, computed with the webhook's secret key. See Webhook Event Signatures.
nonceThe Unix time, in milliseconds, at which the request was signed. It's part of the signed message.

Payload

FieldTypeDescription
request_idstringA unique identifier of this webhook request.
total_countintegerThe number of events in the batch (events).
created_datestringWhen the webhook request was created, as MM/DD/YYYY HH:MM:SS.
eventsarray of objectThe events in this batch.
events[].idstringThe unique identifier of the event. Use it to detect events you already processed.
events[].event_typestringThe type of event. One of event_workflow_run_failure.
events[].dataobjectThe event's data.
events[].data.workflow_run_infoobjectA workflow run that failed.
events[].data.workflow_run_info.workflow_idstringThe identifier of the workflow.
events[].data.workflow_run_info.workflow_run_idstringThe identifier of the run that failed.
events[].data.workflow_run_info.statusstringOne of failed.
events[].data.workflow_run_info.failed_atstring (date-time)When the run failed, in UTC, in ISO 8601.
events[].data.workflow_run_info.errorsarray of objectThe errors of the workflow's steps.
events[].data.workflow_run_info.errors[].node_id (optional)stringThe identifier of the step that failed.
events[].data.workflow_run_info.errors[].error (optional)stringWhat 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

StatusDescription
200Acknowledges 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.
OtherAny 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.