---
title: "Add lead-finder leads to a sequence step (creates prospects for new leads, optionally tags them)"
method: POST
path: "/v1/leads/bulk-actions/add-to-sequence"
tags: ["enrichment"]
---

# Add lead-finder leads to a sequence step (creates prospects for new leads, optionally tags them)

`POST /v1/leads/bulk-actions/add-to-sequence`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/leads/bulk-actions/add-to-sequence`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/leads/bulk-actions/add-to-sequence/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- BulkAddToSequenceDto
  - `leadIds` number[], required: Lead IDs to add to the sequence (max 10000)
  - `sequenceId` string, required: Sequence ID
  - `stepId` string, required: Step ID of the sequence
  - `tagIds` string[]: Existing tag IDs to assign to the leads
  - `newTags` string[]: New tag names to create and assign to the leads

## Response `200`

Leads queued to be added to the sequence

- object
  - `message` string
  - `payload` object
    - `message` string

## Other responses

- `400`: 4000: Failed to add leads to sequence<br><br>
- `401`: 1001: Invalid token<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)