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

# Trigger Follow-up

> Evaluate and send a follow-up message to a lead

This endpoint triggers the AI agent to evaluate a lead and send a follow-up message. Depending on agent configuration, the follow-up may be sent immediately, scheduled for later, or saved as a draft.

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Path Parameters

**leadId** `string` *required*

The unique identifier of the lead

## Response

**success** `boolean`

Whether the follow-up was successfully sent

**leadId** `string`

ID of the lead the follow-up was triggered for

**bodySegments** `string[]`

Follow-up message that was sent

**channel** `enum`

Channel used to send the follow-up (e.g. `SMS`, `EMAIL`, `WHATSAPP`)

**status** `enum`

Status of the follow-up message (e.g. `DRAFT`, `SCHEDULED`, `SENT`)

```javascript Node.js theme={null}
const options = {
  method: "POST",
  headers: {
    "x-api-key": "<your-api-key>",
  },
};

fetch(
  "https://api-v2.getomni.ai/api/v1/leads/a9d0a790-201b-47e9-84ed-cc7eed1270c5/follow-up",
  options,
)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));
```

```python Python theme={null}
import requests

url = "https://api-v2.getomni.ai/api/v1/leads/a9d0a790-201b-47e9-84ed-cc7eed1270c5/follow-up"
headers = {
    "x-api-key": "<your-api-key>",
}

response = requests.request("POST", url, headers=headers)
print(response.json())
```

```bash cURL theme={null}
curl --request POST \
  --url https://api-v2.getomni.ai/api/v1/leads/a9d0a790-201b-47e9-84ed-cc7eed1270c5/follow-up \
  --header 'x-api-key: <your-api-key>'
```

```json 200 theme={null}
{
  "success": true,
  "leadId": "a9d0a790-201b-47e9-84ed-cc7eed1270c5",
  "bodySegments": ["Hi Jordan, just following up on your application."],
  "channel": "SMS",
  "status": "SENT"
}
```


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