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

# Webhook Events

# Webhook Events

This page provides an overview of all available webhook events. Each event type has its own detailed documentation page.

## Event Types

### Action Log Events

Track agent activity and action completion:

> [card] [Action Log Completed](https://docs.monumint.com/api-reference/webhooks/events/action-log-completed.md)
>
> Fired when an action completes successfully

> [card] [Action Log Failed](https://docs.monumint.com/api-reference/webhooks/events/action-log-failed.md)
>
> Fired when an action fails

### Document Events

Track document collection and processing:

> [card] [Document Received](https://docs.monumint.com/api-reference/webhooks/events/document-received.md)
>
> Fired when a document is received

> [card] [Document Extracted](https://docs.monumint.com/api-reference/webhooks/events/document-extracted.md)
>
> Fired when document extraction completes

### Lead Events

Track lead lifecycle:

> [card] [Lead Created](https://docs.monumint.com/api-reference/webhooks/events/lead-created.md)
>
> Fired when a lead is created

> [card] [Lead Updated](https://docs.monumint.com/api-reference/webhooks/events/lead-updated.md)
>
> Fired when a lead is updated

> [card] [Lead Completed](https://docs.monumint.com/api-reference/webhooks/events/lead-completed.md)
>
> Fired when a lead application is completed

### Workflow Run Events

Track the workflows agents conduct on leads:

> [card] [Workflow Run Started](https://docs.monumint.com/api-reference/webhooks/events/workflow-run-started.md)
>
> Fired when an agent starts a workflow on a lead

> [card] [Workflow Run Paused](https://docs.monumint.com/api-reference/webhooks/events/workflow-run-paused.md)
>
> Fired when a workflow run is paused

> [card] [Workflow Run Resumed](https://docs.monumint.com/api-reference/webhooks/events/workflow-run-resumed.md)
>
> Fired when a paused workflow run is resumed

> [card] [Workflow Run Completed](https://docs.monumint.com/api-reference/webhooks/events/workflow-run-completed.md)
>
> Fired when a workflow run completes

> [card] [Workflow Run Cancelled](https://docs.monumint.com/api-reference/webhooks/events/workflow-run-cancelled.md)
>
> Fired when a workflow run is cancelled

## Webhook Delivery

### Request Format

Webhooks are sent as HTTP POST requests with:

* **Content-Type**: `application/json`
* **Method**: POST
* **Body**: JSON payload containing the event data

### Response Requirements

Your webhook endpoint should:

* Return a `200 OK` status code within 5 seconds
* Handle requests asynchronously if processing takes longer
* Return appropriate error codes for invalid requests

### Retry Logic

If your endpoint doesn't respond with a 2xx status code within 5 seconds, Monumint will retry:

* **Initial retry**: After 1 minute
* **Subsequent retries**: Backoff of roughly 2, 5, 10, then 20 minutes
* **Maximum**: 6 total attempts

## Security

### Authenticating Deliveries

Deliveries are not signed. To authenticate them, set custom `headers` on the subscription — for example a shared-secret header — and reject requests to your endpoint that don't carry it. See [Create Webhook](https://docs.monumint.com/api-reference/webhooks/create-webhook.md).

### Best Practices

* Use HTTPS endpoints only
* Reject deliveries that don't carry your secret header
* Implement idempotency to handle duplicate events
* Set up retry logic for failed webhook deliveries
* Monitor webhook delivery status

## Related Guides

> [card] [Webhooks User Guide](https://docs.monumint.com/webhooks.md)
>
> Learn how to set up webhooks

> [card] [Create Webhook API](https://docs.monumint.com/api-reference/webhooks/create-webhook.md)
>
> Create webhooks via API

> [card] [List Webhooks API](https://docs.monumint.com/api-reference/webhooks/list-webhooks.md)
>
> List your webhooks


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