---
title: "Handle user response"
method: POST
path: "/lists/{listID}/reply"
tags: ["lists"]
---

# Handle user response

`POST /lists/{listID}/reply`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}/reply`
- Auth: API key in header `Authorization`

Creates a new user message and handles the input

## Path parameters

- `listID` string, required

## Request body

- UserReplyRequest
  - `text` string, required

## Response `200`

System response

- HandleUserReplyResponse
  - `displayOptions` DisplayOptions
    - `canReply` boolean
    - `leadsDisplayMode` 'none' | 'preview'
    - `progressState` 'none' | 'filtering' | 'searching' | 'completed' | 'failed'
    - `selectedPath` 'none' | 'icp' | 'company_lookalikes' | 'company_followers' | 'uploaded_contacts' | 'extension' | 'signals_funding' | 'signals_investors' | 'signals_job_change' | 'signals_acquisitions' | 'maps_discovery' | 'signals_hiring'
  - `messages` MessageResponse[]
    - `actions` MessageActions
      - `options` MessageAction[]
        - `id` string
        - `text` string
        - `value` string
      - `selectionMode` 'single' | 'suggestion' | 'custom'
    - `created_at` string
    - `extraData` unknown
    - `id` string
    - `role` 'system' | 'user'
    - `status` 'pending' | 'ready'
    - `text` string
  - `refreshContacts` boolean

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/leadsforge/apis/leadsforge-api.md) - [All operations](https://skmtc.dev/leadsforge/apis/leadsforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadsforge/apis/leadsforge-api/revisions/b4a6596215b5?raw)