---
title: "Bulk add contacts to sequence"
method: POST
path: "/v3/sequences/{id}/contact-links/bulk"
tags: ["Sequence Contacts"]
---

# Bulk add contacts to sequence

`POST /v3/sequences/{id}/contact-links/bulk`

<small>_Requires the `sequences:operate` scope (or a broader one that includes it)._</small>

Add multiple contacts to the sequence at once

## Path parameters

- `id` integer, required

## Request body

- object
  - `contactIds` integer[], required — Array of contact IDs to add
  - `removeFromExisting` boolean — If true, contacts will be removed from their current sequences before being added to this one
  - `startStepId` integer, nullable — Optional step ID to start from
  - `ignoreStepDelay` boolean — If true, skip the configured delay before the first step and start processing immediately
  - `startFrom` string, date-time, nullable — Optional date when contact processing should begin. If not provided, processing starts immediately.

## Response `200`

Contacts added to sequence.

Per-item failures use the `SequenceContactError` enum. Common per-item slugs:

| Slug | Meaning |
| --- | --- |
| `invalidInput` | Generic validation failure for this contact |
| `contactLimitExceeded` | Plan limit reached |
| `contactAlreadyInSequence` | Contact is already enrolled |
| `contactNotFound` | Contact does not exist |
| `forbidden` | Caller lacks permission for this contact |

- object
  - `added` integer[] — IDs of successfully added contacts
  - `notProcessed` object — Contacts that could not be added, keyed by contact ID

## Other responses

- `400` — Validation failure on the route parameter or request body, or a business rule rejection (e.g. sequence has no steps).
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — User lacks required feature scope to modify this sequence
- `404` — Sequence not found
- `429` — Too Many Requests

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)