> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getomni.ai/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

<ParamField path="leadId" type="string" required>
  The unique identifier of the lead
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the follow-up was successfully sent
</ResponseField>

<ResponseField name="leadId" type="string">
  ID of the lead the follow-up was triggered for
</ResponseField>

<ResponseField name="bodySegments" type="string[]">
  Follow-up message that was sent
</ResponseField>

<ResponseField name="channel" type="enum">
  Channel used to send the follow-up (e.g. `SMS`, `EMAIL`, `WHATSAPP`)
</ResponseField>

<ResponseField name="status" type="enum">
  Status of the follow-up message (e.g. `DRAFT`, `SCHEDULED`, `SENT`)
</ResponseField>

<RequestExample>
  ```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>'
  ```
</RequestExample>

<ResponseExample>
  ```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"
  }
  ```
</ResponseExample>