---
title: "Create new leads in bulk"
method: POST
path: "/v3/user-api/leads"
tags: ["Leads"]
---

# Create new leads in bulk

`POST /v3/user-api/leads`

## 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/leads`
- Auth: none declared. Required headers: `x-personal-api-key`

Add multiple leads to a lead list. Each lead requires an email address and lead list ID. Supports duplicate detection and comprehensive contact information including custom variables and personalization data.

## Headers

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

## Request body

- CreateLeadsApiDto
  - `leads` CreateSingleLeadDto[], required: Array of leads to create
    - `address` string, required: Email address of the lead (required)
    - `firstName` string: First name of the lead
    - `lastName` string: Last name of the lead
    - `companyName` string: Company name
    - `linkedInUrl` string: LinkedIn profile URL
    - `websiteUrl` string: Website URL
    - `personalization` string: AI-generated personalization text for the lead
    - `otherVariables` OtherVariableDto[]: Custom variables as key-value pairs
      - `name` string, required: Variable name
      - `value` string, required: Variable value
    - `leadListId` string, required: Lead list ID to associate this lead with (required)
  - `skipDuplicates` boolean: Skip duplicate email addresses (default: true)

## Response `201`

- CreateLeadsResponseDto
  - `message` string, required
  - `data` BulkLeadCreationDataDto, required
    - `acceptedCount` number, required: Number of leads successfully created
    - `rejectedCount` number, required: Number of leads rejected (duplicates or errors)
    - `result` LeadDto[], required: Array of created lead objects
      - `address` string, required
      - `firstName` string
      - `lastName` string
      - `companyName` string
      - `linkedInUrl` string
      - `websiteUrl` string
      - `personalization` string
      - `domain` string, required
      - `notes` string[], required
      - `otherVariables` OtherVariableDto[]
        - `name` string, required: Variable name
        - `value` string, required: Variable value
      - `completedStepIds` string[], required
      - `receivedEmails` string[], required
      - `leadListId` string, required
      - `owner` string, required
      - `replied` boolean, required
      - `opened` boolean, required
      - `clicked` boolean, required
      - `bounced` boolean, required
      - `stopped` boolean, required
      - `isDeleted` boolean, required
      - `_id` string, required
      - `nextSendingDate` string, 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)