---
title: "Bulk Start Sequences"
method: POST
path: "/api/v1/sequences/bulk-start"
tags: ["sequences"]
---

# Bulk Start Sequences

`POST /api/v1/sequences/bulk-start`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/sequences/bulk-start`
- Auth: HTTP bearer

Start outreach for exactly the named leads that don't have a sequence
yet. Auto-picks the best available LinkedIn account.

Audit 2026-09-29 §2: this used to take no body and start EVERY lead in the
account without a sequence, while the leads page counted only the new
leads in the current filter — "Start all (1)" on campaign A could start
campaign B's ten too. The page now sends the leads it counted; ids that are
not the caller's, or already in outreach, are ignored.

## Request body

- BulkStartRequest: The leads "Start all" counted (audit 2026-09-29 §2) — the action must touch exactly the set the button showed.
  - `lead_ids` string[], required

## Response `201`

Successful Response

- SequenceOut[]
  - `id` string, uuid, required
  - `lead_id` string, uuid, required
  - `account_id` string, uuid, nullable, required
  - `current_step` 'pending' | 'warmup_view' | 'warmup_like' | 'warmup_comment' | 'linkedin_invite' | 'linkedin_followup_1' | 'linkedin_followup_2' | 'email_1' | 'email_2' | 'completed', required
  - `status` 'active' | 'paused' | 'completed' | 'stopped', required
  - `mode` 'auto' | 'preview' | 'manual', required
  - `warmup_done` boolean, required
  - `next_action_at` string, date-time, nullable, required
  - `pause_reason` string, nullable, required
  - `stopped_reason` string, nullable, required
  - `steps_done` integer, required
  - `steps_total` integer, required
  - `comment_posted` boolean
  - `preview_pending` boolean
  - `invite_accepted_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

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