---
title: "Create a new lead list"
method: POST
path: "/v3/user-api/leadlists"
tags: ["Lead Lists"]
---

# Create a new lead list

`POST /v3/user-api/leadlists`

## Request

- Base URL: `https://api.nureply.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nureply.com/v3/user-api/leadlists`
- Auth: none declared. Required headers: `x-personal-api-key`

Create a new empty lead list to organize your leads. Lead lists are containers that group leads for targeting in campaigns. The list can be populated later by adding leads via the leads endpoints.

## Headers

- `x-personal-api-key` string, required

## Request body

- CreateLeadlistApiDto
  - `name` string, required: Name of the lead list

## Response `201`

- CreateLeadListResponseDto
  - `message` string, required
  - `data` LeadListDto, required
    - `_id` string, required
    - `userId` string
    - `organization` string
    - `file_name` string, required
    - `status` string, required
    - `statusMessage` string
    - `processingCount` number
    - `isUsedInCampaign` boolean, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `id` string, required

## Other responses

- `400`
- `401`

---

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