---
title: "Enroll a contact in a sequence"
method: POST
path: "/automation/v4/sequences/enrollments"
tags: ["Basic"]
---

# Enroll a contact in a sequence

`POST /automation/v4/sequences/enrollments`

Enroll a contact into a sequence using the specified user ID and sequence details.

## Query parameters

- `userId` string, required

## Request body

- PublicSequenceEnrollmentRequest
  - `contactId` string, required — The unique identifier of the contact to be enrolled in the sequence.
  - `senderAliasAddress` string — The alias email address used by the sender when enrolling the contact.
  - `senderEmail` string, required — The email address of the sender enrolling the contact in the sequence.
  - `sequenceId` string, required — The unique identifier of the sequence in which the contact will be enrolled.

## Response `200`

successful operation

- PublicSequenceEnrollmentLiteResponse
  - `enrolledAt` string, date-time, required — The date and time when the contact was enrolled in the sequence.
  - `id` string, required — The unique identifier for the sequence enrollment.
  - `toEmail` string, required — The email address of the contact enrolled in the sequence.
  - `updatedAt` string, date-time, required — The date and time when the sequence enrollment was last updated.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-08-15** (v4) `1eeb2fde6883` — 1 info
  - endpoint added
- **2026-07-13** (v4) `9806ae62d2f1` — 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v4) `4437b130c791` — 2 info
  - the security scope `automation.sequences.enrollments.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `sequences-enrollments-public-write-access` was removed from the endpoint's security scheme `oauth2`
- **2026-04-15** (v4) `f02323380ddf` — 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-11** (v4) `4d21ec788967` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubspot/apis/automation-sequences/changes/automation/v4/sequences/enrollments/post.md)

---

[API](https://skmtc.dev/hubspot/apis/automation-sequences.md) · [All operations](https://skmtc.dev/hubspot/apis/automation-sequences/llms.txt) · [OpenAPI document](https://skmtc.dev/hubspot/apis/automation-sequences/revisions/047269554830?raw)