---
title: "POST /enrollments"
method: POST
path: "/enrollments"
tags: ["Sequences", "Sequence Enrollments"]
---

# POST /enrollments

`POST /enrollments`

## Request body

- CreateEnrollmentRequest — Request body for enrolling a person in a sequence.
  - `sequence_id` string, uuid, required
  - `person_id` string, uuid, required
  - `mailbox_emails` Email[], required — Candidate mailbox addresses to send from. One is selected at enrollment time. At most 10 addresses are accepted.

## Response `201`

Response returned when an enrollment is created.

- CreateEnrollmentSuccessResponse — A sequence enrollment.
  - `id` string, uuid, required
  - `created_at` string, date-time, required — String value representing an RFC 3339 datetime.
  - `updated_at` string, date-time, required — String value representing an RFC 3339 datetime.
  - `sequence` EnrollmentSequence, required — Sequence details embedded in enrollment responses.
    - `id` string, uuid, required
    - `name` string, required
    - `is_paused` boolean, required
  - `person` EnrollmentPerson, required — Person details embedded in enrollment responses.
    - `id` string, uuid, required
    - `email` string, email, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `linkedin_url` string, nullable, required
  - `mailbox` EnrollmentMailbox, required — Mailbox details embedded in enrollment responses.
    - `id` string, uuid, required
    - `email` string, email, required
    - `display_name` string, nullable, required
    - `is_paused` boolean, required
    - `is_unauthorized` boolean, required
  - `reply_email_message` EnrollmentReplyEmailMessage, required — Reply email message details embedded in sequence API results.
    - `id` string, uuid, required
    - `subject` string, nullable, required
    - `classifications` ReplyEmailClassification[], required
      - `id` string, uuid, required
      - `category` 'AUTOMATED' | 'NEGATIVE' | 'NEUTRAL' | 'POSITIVE', required — Reply classification category.
  - `status` 'DRAFT' | 'IN_PROGRESS' | 'FINISHED', required — Status of a sequence enrollment.
  - `is_blocked` boolean, required
  - `is_bounced` boolean, required
  - `is_canceled` boolean, required
  - `is_excluded` boolean, required
  - `is_opted_out` boolean, required
  - `is_paused` boolean, required
  - `is_replied` boolean, required
  - `started_at` string, date-time, required — String value representing an RFC 3339 datetime.
  - `ended_at` string, date-time, required — String value representing an RFC 3339 datetime.

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `404` — Response returned when an enrollment cannot be found.
- `409` — Response returned when the person is already enrolled in an active sequence.
- `429` — Response for any operation that exceeds a rate limit.
- `500` — Response for any operation that results in an internal server error.

---

[API](https://skmtc.dev/unifygtm/apis/unify-analytics-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-analytics-api/revisions/2f145e6f6d7e/schema)