---
title: "Enroll a recipient in an outreach sequence"
method: POST
path: "/outreach-sequences/{id}/runs"
tags: ["Outreach Sequences"]
---

# Enroll a recipient in an outreach sequence

`POST /outreach-sequences/{id}/runs`

Create a new outreach sequence run, enrolling a candidate (or a client contact tied to a candidate) in the sequence.

## Path parameters

- `id` string, required

## Request body

- CreateOutreachSequenceRunSingleDto
  - `run` union, required
    - object
      - `candidateId` string, required — For a candidate enrollment, the candidate to enroll. For a client-contact enrollment, the candidate linked to the client contact.
      - `type` 'candidate', required — Discriminator value for a candidate enrollment.
    - object
      - `candidateId` string, required — For a candidate enrollment, the candidate to enroll. For a client-contact enrollment, the candidate linked to the client contact.
      - `type` 'clientContact', required — Discriminator value for a client-contact enrollment.
      - `clientContactId` string, required — ID of the client contact to enroll.

## Response `201`

Recipient enrolled successfully. Returns the run ID.

- CreateRecordResponseDto
  - `id` string, required

## Other responses

- `400` — Bad request - invalid recipient type for the sequence purpose
- `401` — Unauthorized - invalid or missing authentication
- `403` — Forbidden - delegated sending is disabled and the requester is not the sequence owner
- `404` — Sequence or candidate not found
- `409` — A run for this recipient already exists in the sequence
- `500` — Error response

---

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