---
title: "Bulk personalize all leads in a lead list"
method: POST
path: "/v3/user-api/personalization/leadlist/{leadListId}"
tags: ["Personalization"]
---

# Bulk personalize all leads in a lead list

`POST /v3/user-api/personalization/leadlist/{leadListId}`

## 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/personalization/leadlist/{leadListId}`
- Auth: none declared. Required headers: `x-personal-api-key`

Generate AI-powered personalization for all leads in a lead list. This is an asynchronous operation that queues personalization jobs for processing. Use isOnlyMissing=true to only personalize leads without existing personalization. Credits are consumed as leads are processed.

## Path parameters

- `leadListId` string, required

## Headers

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

## Request body

- PersonalizeLeadListDto
  - `writingStyle` 'formal' | 'casual' | 'funny': Writing style for the personalization
  - `language` 'English' | 'German' | 'French' | 'Turkish' | 'Dutch' | 'Spanish': Language for the personalization
  - `customPrompt` string: Custom prompt for additional AI instructions (max 500 chars)
  - `source` 'linkedin' | 'website' | 'both', required: Source to use for personalization (uses each lead's linkedInUrl and/or websiteUrl)
  - `isOnlyMissing` boolean: Only personalize leads without existing personalization

## Response `200`

- LeadListPersonalizationResponseDto
  - `message` string, required
  - `data` LeadListPersonalizationDataDto, required
    - `leadListId` string, required: The MongoDB ObjectId of the lead list
    - `queueStatus` 'processing' | 'queued', required: Current status of the bulk personalization job
    - `totalLeads` number, required: Total number of leads in the list
    - `leadsToPersonalize` number, required: Number of leads that will be personalized (may be less if isOnlyMissing=true)
    - `estimatedCredits` number, required: Estimated credits that will be consumed
    - `estimatedCompletionTime` string: Estimated completion time (ISO 8601 format)

## Other responses

- `400`
- `401`
- `404`

---

[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)