---
title: "Add prospects to a sequence."
method: POST
path: "/api/external/sequences/recipients/add"
tags: ["Sequence APIs"]
---

# Add prospects to a sequence.

`POST /api/external/sequences/recipients/add`

<br/>Enrols one or more prospects (candidates or contacts) into an existing<br/>sequence and launches the sequence for the newly added recipients.<br/><br/>All `prospect_ids` must match the sequence's type (a Candidate sequence<br/>accepts only candidates, a Contact sequence only contacts). Because the API<br/>key is account-scoped rather than user-scoped, `user_id` is required and<br/>identifies the user recorded as performing the action; it must belong to<br/>your account.<br/><br/>Prospects that are already enrolled (or whose launch fails) are reported<br/>under `recipient_failures` rather than being re-added.<br/>

## Headers

- `RF-Api-Key` string, required
- `content-type` string

## Request body

- object
  - `prospect_ids` integer[], required — Ids of the candidates/contacts to enrol.
  - `sequence_id` integer, required — Id of the sequence to add recipients to.
  - `user_id` integer, required — Id of the user performing the action (must be in your account).

## Response `200`

Recipients processed

- unknown

## Other responses

- `400` — Validation error

## Changes

- **2026-08-13** `febc104d89ff` — 1 breaking
  - the `header` request parameter `RF-Api-Key` became required

[Change history](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/changes/api/external/sequences/recipients/add/post.md)

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/febc104d89ff/schema)