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

# workflow_run.started

Triggered when an agent starts a workflow on a lead.

## Event Type

`workflow_run.started`

## Description

This event fires whenever a workflow run is created: through [Create Workflow Run](/api-reference/workflow-runs/create-workflow-run), from the Monumint app, or automatically when your workspace is configured to start a workflow on lead creation or CRM sync. Workflow runs on a test lead do not emit webhooks.

## Payload Structure

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

<ResponseField name="actor" type="object | null">
  The workspace user who made the change. `null` when the change came from the
  API or from Monumint itself. API keys authenticate a workspace rather than a
  person.

  <Expandable title="actor">
    <ResponseField name="type" type="enum">
      Type of actor
    </ResponseField>

    <ResponseField name="id" type="string">
      Unique identifier for the user
    </ResponseField>

    <ResponseField name="name" type="string | null">
      Name of the user
    </ResponseField>

    <ResponseField name="email" type="string">
      Email address of the user
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

<ResponseField name="leadId" type="string" required>
  The lead the workflow is conducted on.
</ResponseField>

<ResponseField name="externalLeadId" type="string | null">
  The lead's identifier in your own system, if you set one.
</ResponseField>

<ResponseField name="workflowRun" type="object" required>
  The workflow run, the same object the
  [workflow run endpoints](/api-reference/workflow-runs/get-workflow-run) return.

  <Expandable title="workflowRun">
    <ResponseField name="id" type="string" required>
      The workflow run id. Pass it to the
      [workflow run endpoints](/api-reference/workflow-runs/get-workflow-run).
    </ResponseField>

    <ResponseField name="leadId" type="string" required>
      The lead the workflow is conducted on.
    </ResponseField>

    <ResponseField name="agentId" type="string" required>
      The agent conducting the workflow.
    </ResponseField>

    <ResponseField name="workflowId" type="string" required>
      The workflow being conducted.
    </ResponseField>

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

    <ResponseField name="createdAt" type="string" required>
      When the workflow run started.
    </ResponseField>

    <ResponseField name="completedAt" type="string | null" required>
      When the workflow run completed, or `null`.
    </ResponseField>

    <ResponseField name="cancelledAt" type="string | null" required>
      When the workflow run was cancelled, or `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "event": "workflow_run.started",
    "actor": null,
    "occurredAt": "2026-09-10T17:42:03.000Z",
    "workspaceId": "6048d78a-584a-4f1e-9e39-e011ca4cc48c",
    "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
    "externalLeadId": "crm-4471",
    "workflowRun": {
      "id": "5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9",
      "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
      "agentId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "workflowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "ACTIVE",
      "createdAt": "2026-09-10T17:42:03.000Z",
      "completedAt": null,
      "cancelledAt": null
    }
  }
  ```
</ResponseExample>