workflow_run.expired

{
  "event": "workflow_run.expired",
  "actor": null,
  "occurredAt": "2026-09-10T18:05:00.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",
    "portalUrl": null,
    "externalId": null,
    "status": "EXPIRED",
    "createdAt": "2026-09-10T17:42:03.000Z",
    "completedAt": null,
    "cancelledAt": null,
    "expiredAt": "2026-09-10T18:05:00.000Z"
  }
}

{
  "event": "workflow_run.expired",
  "actor": null,
  "occurredAt": "2026-09-10T18:05:00.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",
    "portalUrl": null,
    "externalId": null,
    "status": "EXPIRED",
    "createdAt": "2026-09-10T17:42:03.000Z",
    "completedAt": null,
    "cancelledAt": null,
    "expiredAt": "2026-09-10T18:05:00.000Z"
  }
}

Triggered when a workflow run expires after a period of inactivity.

Event Type

workflow_run.expired

Description

This event fires when a workflow run has gone without activity for longer than its workflow’s expiry setting. Activity is any message sent to or received from the lead, the lead uploading a document, calling in, or using the portal, a manual update, or checklist progress. Expiry is configured per workflow in the Monumint app, only applies to checklist workflows, and only applies to ACTIVE runs. Paused runs never expire. An expired run comes back as ACTIVE on its own when the lead replies, calls, or opens the portal, and a workspace user can reactivate it from the Monumint app. Either way a workflow_run.resumed event follows.

Payload Structure

string

required

The event type: workflow_run.expired

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

required

The portal URL for this run, or null. When set, it is the link the lead receives, overriding the lead’s own portal link and the workflow’s portal URL template.

string | null

required

Your identifier for this run, or null. Set it when you create the run.

string

required

Always EXPIRED 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.

string | null

required

When the workflow run expired from inactivity, or null.

{
  "event": "workflow_run.expired",
  "actor": null,
  "occurredAt": "2026-09-10T18:05:00.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",
    "portalUrl": null,
    "externalId": null,
    "status": "EXPIRED",
    "createdAt": "2026-09-10T17:42:03.000Z",
    "completedAt": null,
    "cancelledAt": null,
    "expiredAt": "2026-09-10T18:05:00.000Z"
  }
}

Getting Started

Leads

Workflow Runs

Agents

Workflows

Documents

Analytics

Webhooks

Event Type

Description

Payload Structure

​Event Type

​Description

​Payload Structure

Event Type

Description

Payload Structure