> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# spread.started

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

<ResponseField name="event" type="string" required>
  The event type: `spread.started`
</ResponseField>

<ResponseField name="actor" type="null">
  Always `null` for spread events.
</ResponseField>

<ResponseField name="occurredAt" type="string" required>
  ISO 8601 timestamp of when the event was emitted.
</ResponseField>

<ResponseField name="data" type="object" required>
  The run data.

  <Expandable title="data">
    <ResponseField name="spreadId" type="string" required>
      The spreading run id.
    </ResponseField>

    <ResponseField name="leadId" type="string" required>
      The lead the run belongs to.
    </ResponseField>

    <ResponseField name="externalLeadId" type="string | null">
      The lead's external identifier, if set.
    </ResponseField>

    <ResponseField name="workspaceId" type="string" required>
      The workspace the run belongs to.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Always `IN_PROGRESS` for this event.
    </ResponseField>

    <ResponseField name="documents" type="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.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "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" }
      ]
    }
  }
  ```
</ResponseExample>