workflow_run.started

{
  "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
  }
}

{
  "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
  }
}

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, 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

string

required

The event type: workflow_run.started

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.

Show actor

enum

Type of actor

string

Unique identifier for the user

string | null

Name of the user

string

Email address of the user

string

required

ISO 8601 timestamp of when the event was emitted.

string

required

The workspace the workflow run belongs to.

string

required

The lead the workflow is conducted on.

string | null

The lead’s identifier in your own system, if you set one.

object

required

The workflow run, the same object the workflow run endpoints return.

Show workflowRun

string

required

The workflow run id. Pass it to the workflow run endpoints.

string

required

The lead the workflow is conducted on.

string

required

The agent conducting the workflow.

string

required

The workflow being conducted.

string

required

Always ACTIVE for this event.

string

required

When the workflow run started.

string | null

required

When the workflow run completed, or null.

string | null

required

When the workflow run was cancelled, or 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
  }
}

Getting Started

Leads

Workflow Runs

Agents

Workflows

Documents

Spreads

Artifacts

Analytics

Webhooks

Event Type

Description

Payload Structure

​Event Type

​Description

​Payload Structure

Event Type

Description

Payload Structure