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

# lead.completed

Triggered when a lead application is completed.

## Event Type

`lead.completed`

## Description

This event is fired when all required checklist items for a lead have been completed or marked as needs review. Use this event to trigger downstream processing, notify your team, or sync the completed application to your systems.

This event fires only once per lead.

## Payload Structure

**event** `string` *required*

The event type: `lead.completed`

**data** `object` *required*

The completed lead data

**data**

**leadId** `string` *required*

Unique identifier for the lead

**externalId** `string | null`

External identifier for the lead (if set)

**workflowRunId** `string | null`

ID of the workflow run whose completion completed the lead. `null` when a person or the API completed the lead directly.

**externalWorkflowRunId** `string | null`

Your own identifier for that workflow run, if you set one when creating it

**firstName** `string | null`

Lead's first name

**middleName** `string | null`

Lead's middle name

**lastName** `string | null`

Lead's last name

**phoneNumber** `string | null`

Lead's phone number (E.164 format, e.g., `+15551234567`)

**email** `string | null`

Lead's email address

**businessName** `string | null`

Lead's business name

**website** `string | null`

Lead's website URL

**source** `string | null`

How the lead was created: `inbound-email`, `inbound-sms`, `inbound-whatsapp`, `admin-email`, `portal`, `api`, `http`, `salesforce`

**tags** `string[]`

Tags attached to the lead at completion, or an empty array when none

**checklistItems** `array` *required*

All checklist items for the lead

**checklistItems**

**checklistItemId** `string`

ID of the checklist item definition

**checklistGroupCode** `string`

Code identifier for the checklist item's group

**checklistItemCode** `string`

Code identifier for the checklist item

**value** `string | number | object | null`

Current value of the checklist item. Type depends on the field type: `string` for text fields, `number` for numeric fields, or an address object with the following structure: `{ "street": "...", "city": "...", "state": "...", "postalCode": "...", "country": "..." }`.

**alternateValues** `array | null`

Alternative extracted values

**alternateValues**

**value** `string`

The alternate extracted value

**parentActionId** `string | null`

ID of the action that produced this value

**status** `string`

Status: `TODO`, `COMPLETED`, `INVALID`, `SKIPPED`, `NEEDS_REVIEW`

**updatedAt** `string`

ISO 8601 timestamp of the last update

**documents** `array`

Array of documents associated with the checklist item (only for file-type fields)

**documents**

**documentId** `string`

Unique identifier for the document

**externalId** `string | null`

External identifier for the document

**filename** `string`

Original filename

**mimeType** `string`

MIME type of the document

**size** `number`

File size in bytes

**s3Bucket** `string`

S3 bucket name (only included if external S3 integration is configured)

**s3Key** `string`

S3 object key (only included if external S3 integration is configured)

**validationResult** `object | null`

Document validation results (if validation rules are configured)

**validationResult**

**documentId** `string`

ID of the validated document

**overallValid** `boolean`

Whether the document passed all validation rules

**otherNotes** `string | null`

Additional notes from validation

**validationResults** `array`

Individual rule results

**validationResults**

**isValid** `boolean`

Whether this rule passed

**ruleName** `string`

Name of the validation rule

**ruleIndex** `number`

Index of the rule

**isValidReason** `string`

Explanation of why the rule passed or failed

**leadChecklistItemId** `string`

ID of the associated checklist item

**overallValid** `boolean | null`

Whether the document passed all validation rules

```json theme={null}
{
  "event": "lead.completed",
  "data": {
    "leadId": "50713355-df73-4077-9d84-dcda6da5729c",
    "externalId": "ext-lead-001",
    "workflowRunId": "5d8c1f3a-7b2e-4c9d-8e1f-2a3b4c5d6e7f",
    "externalWorkflowRunId": "crm-run-8813",
    "firstName": "John",
    "middleName": null,
    "lastName": "Doe",
    "phoneNumber": "+15551234567",
    "email": "john@example.com",
    "businessName": "Acme Inc",
    "website": "https://acme.com",
    "source": "inbound-email",
    "tags": ["VIP", "priority-1"],
    "checklistItems": [
      {
        "checklistItemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "checklistItemCode": "company_name",
        "value": "Acme Inc",
        "alternateValues": [],
        "status": "COMPLETED",
        "updatedAt": "2025-10-31T18:30:00.000Z"
      },
      {
        "checklistItemId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "checklistItemCode": "bank_statement",
        "value": "bank-statement-oct.pdf",
        "alternateValues": [],
        "status": "COMPLETED",
        "updatedAt": "2025-10-31T19:00:01.675Z",
        "documents": [
          {
            "documentId": "8349efe7-3c68-49c3-9411-f9affda0d03a",
            "externalId": null,
            "filename": "bank-statement-oct.pdf",
            "mimeType": "application/pdf",
            "size": 153143,
            "validationResult": {
              "documentId": "8349efe7-3c68-49c3-9411-f9affda0d03a",
              "overallValid": true,
              "otherNotes": null,
              "validationResults": [
                {
                  "isValid": true,
                  "ruleName": "First name should match",
                  "ruleIndex": 0,
                  "isValidReason": "Lead first name 'John' matches document name 'JOHN'."
                },
                {
                  "isValid": true,
                  "ruleName": "Statement must be dated within the last 3 months",
                  "ruleIndex": 1,
                  "isValidReason": "October 2025 is within the required period."
                }
              ],
              "leadChecklistItemId": "f830cc29-16ad-4c64-9fa8-f90f318f8dce"
            },
            "overallValid": true
          }
        ]
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.