---
title: "Add leads to sequence"
method: POST
path: "/v2/sequences/{sequence_id}/leads"
tags: ["Sequence Leads"]
---

# Add leads to sequence

`POST /v2/sequences/{sequence_id}/leads`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/sequences/{sequence_id}/leads`
- Auth: HTTP bearer

Add multiple leads to a sequence by their lead identifiers (person IDs)

## Path parameters

- `sequence_id` string, required: Encrypted sequence identifier

## Request body

- AddLeadsRequest: Request to add leads to a sequence using lead identifiers (person IDs as strings or numbers)
  - `lead_identifiers` union[], required
    - union
      - string
      - integer

## Response `200`

Leads added to sequence successfully

- object
  - `data` object, required
    - `added_leads` object[], required
      - `id` string, required: Encrypted lead identifier
      - `village_person_id` number, required
      - `status` 'active' | 'not_started' | 'pending' | 'finished' | 'deleted', required: Status of the lead within the sequence
    - `skipped_leads` object[], required
      - `village_person_id` number, required
      - `reason` string, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Sequence not found

---

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