spread.started

{
  "event": "spread.started",
  "actor": null,
  "occurredAt": "2026-07-23T18:04:00.000Z",
  "data": {
    "spreadId": "9f1e2d3c-4b5a-6789-0abc-def012345678",
    "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
    "externalLeadId": "crm-4471",
    "workspaceId": "ws-1",
    "status": "IN_PROGRESS",
    "documents": [
      { "id": "doc-a", "filename": "2023-tax-return.pdf", "status": "PROCESSING" },
      { "id": "doc-b", "filename": "2023-financials.pdf", "status": "PROCESSING" }
    ]
  }
}

Triggered when a financial spreading run starts.

Event Type

spread.started

Description

This event fires whenever a spreading run is created and queued, whether it was started through the API or from the Omni app. A regenerated run re-emits it. The run is IN_PROGRESS; a first run has no artifacts yet, while a regenerating run keeps its previous artifacts until the new ones replace them on completion. Spreads not tied to a lead and spreads on a test lead do not emit webhooks.

Payload Structure

string

required

The event type: spread.started

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 IN_PROGRESS 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.

{
  "event": "spread.started",
  "actor": null,
  "occurredAt": "2026-07-23T18:04:00.000Z",
  "data": {
    "spreadId": "9f1e2d3c-4b5a-6789-0abc-def012345678",
    "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
    "externalLeadId": "crm-4471",
    "workspaceId": "ws-1",
    "status": "IN_PROGRESS",
    "documents": [
      { "id": "doc-a", "filename": "2023-tax-return.pdf", "status": "PROCESSING" },
      { "id": "doc-b", "filename": "2023-financials.pdf", "status": "PROCESSING" }
    ]
  }
}

lead.completed 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