spread.failed

{
  "event": "spread.failed",
  "actor": null,
  "occurredAt": "2026-07-23T18:06:20.000Z",
  "data": {
    "spreadId": "9f1e2d3c-4b5a-6789-0abc-def012345678",
    "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
    "externalLeadId": "crm-4471",
    "workspaceId": "ws-1",
    "status": "FAILED",
    "documents": [
      { "id": "doc-a", "filename": "2023-tax-return.pdf", "status": "FAILED" }
    ],
    "error": "Unable to extract financial data from the uploaded documents."
  }
}

Triggered when a financial spreading run fails.

Event Type

spread.failed

Description

This event fires when a spreading run fails. data.error carries a short, human-readable reason for the failure. There are no artifacts. Spreads not tied to a lead and spreads on a test lead do not emit webhooks.

Payload Structure

string

required

The event type: spread.failed

null

Always null for spread events.

string

required

ISO 8601 timestamp of when the event was emitted.

object

required

The run data.

Show data

string

required

The spreading run id.

string

required

The lead the run belongs to.

string | null

The lead’s external identifier, if set.

string

required

The workspace the run belongs to.

string

required

Always FAILED for this event.

array

required

The input documents, each with id, filename, and status. id is the document’s id in your workspace, or null if the document has since been deleted.

string | null

The failure message.

{
  "event": "spread.failed",
  "actor": null,
  "occurredAt": "2026-07-23T18:06:20.000Z",
  "data": {
    "spreadId": "9f1e2d3c-4b5a-6789-0abc-def012345678",
    "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
    "externalLeadId": "crm-4471",
    "workspaceId": "ws-1",
    "status": "FAILED",
    "documents": [
      { "id": "doc-a", "filename": "2023-tax-return.pdf", "status": "FAILED" }
    ],
    "error": "Unable to extract financial data from the uploaded documents."
  }
}

spread.completed

Getting Started

Leads

Documents

Spreads

Artifacts

Analytics

Webhooks

Event Type

Description

Payload Structure

​Event Type

​Description

​Payload Structure

Event Type

Description

Payload Structure