---
title: "Create a sequence"
method: POST
path: "/v1/sequences"
tags: ["Sequences"]
---

# Create a sequence

`POST /v1/sequences`

Creates a new sequence. Use the /users endpoint to get organizationMembershipIds for assignedToIds and creatorId.

## Headers

- `x-workspace-id` string, uuid

## Request body

- CreateSequenceDto
  - `name` string, required — Sequence name
  - `assignedToIds` string[], required — OrganizationMembership IDs of users to assign this sequence to
  - `creatorId` string, required — OrganizationMembership ID of the creator. Use the /users endpoint to get available organizationMembershipIds.
  - `contactIds` string[] — Contact IDs to add to the sequence

## Response `201`

Sequence created successfully

- SequenceDto
  - `id` string, required — Unique identifier of the sequence
  - `name` string, required — Name of the sequence
  - `organizationMembershipId` string, required — OrganizationMembership ID of the creator
  - `createdAt` string, date-time, required — Date when the sequence was created
  - `updatedAt` string, date-time, required — Date when the sequence was last updated
  - `contactCount` number — Number of contacts in the sequence
  - `assignedTo` AssignedUserDto[] — List of users assigned to this sequence
    - `organizationMembershipId` string, required — OrganizationMembership ID of the assigned user
    - `firstName` object, nullable — First name of the assigned user
    - `lastName` object, nullable — Last name of the assigned user
    - `email` string, required — Email of the assigned user

## Other responses

- `401` — Invalid or missing API key
- `403` — Subscription required or plan not eligible

---

[API](https://skmtc.net/skipcall/apis/skipcall-public-api.md) · [All operations](https://skmtc.net/skipcall/apis/skipcall-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skipcall/skipcall-public-api/versions/f594352719bd/schema)