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

# Create a sequence

`POST /v4/sequences`

Creates an empty sequence — the container that holds sequence emails. After creating the shell, use [Create a sequence email](/api-reference/sequence-emails/create-a-sequence-email) to populate it.

Only `name` is required. Every other field has a sensible default: Kit fills in the account's default sending address, a daily send schedule, and the account time zone — and any of these can be tuned later via [Update a sequence](/api-reference/sequences/update-a-sequence).

Two behavioural toggles worth flagging up front. `repeat` controls whether a subscriber can re-enter the sequence: by default a subscriber receives the emails once and is marked complete, but with `repeat: true`, re-adding the same subscriber via a Visual Automation, Rule, Bulk Action, or Import resets their position to the start. Filters and exclusions still apply across restarts. `hold` (evergreen) keeps subscribers active in the sequence after they've received every published email — useful when you plan to add more emails later. Without `hold`, subscribers transition to Completed and won't pick up future additions.

`exclude_subscriber_sources` lets you exclude subscribers acquired via specific tags, sequences, forms, or segments — they'll skip this sequence entirely.

For end-user context, see the help articles on [creating and sending a sequence](https://help.kit.com/en/articles/2502629-creating-and-sending-a-sequence-in-kit), [restarting a sequence](https://help.kit.com/en/articles/5022528-restart-a-sequence), and [holding subscribers in evergreen sequences](https://help.kit.com/en/articles/5192801-how-to-hold-subscribers-in-evergreen-sequences).

## Request body

- object
  - `name` string — The name of the sequence.
  - `email_address` string — The sending email address to use. Uses the account's sending email address if not provided.
  - `email_template_id` integer — Id of the email template to use.
  - `send_days` string[] — The days of the week to send the sequence on. Must be one of: `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, `sunday`.
  - `send_hour` integer — The hour of the day to send the sequence at. Must be an integer between 0 and 23.
  - `time_zone` string — The timezone to use for the sequence. Must be a valid IANA timezone string.
  - `active` boolean — `true` to activate the sequence, `false` to deactivate it.
  - `repeat` boolean — When `true`, subscribers can restart the sequence multiple times.
  - `hold` boolean — When `true`, subscribers added via Visual Automations stay in the sequence after receiving the last email.
  - `exclude_subscriber_sources` object[] — The subscriber sources to exclude from the sequence.
    - `type` string, required — The type of subscriber source to exclude. Must be one of: `tag`, `sequence`, `form`, `segment`.
    - `ids` integer[], required

## Response `201`

Creates a new sequence

- object
  - `sequence` object, required
    - `id` integer, required
    - `name` string, required
    - `hold` boolean, required
    - `repeat` boolean, required
    - `created_at` string, required
    - `updated_at` string, required
    - `email_address` string, required
    - `email_template_id` integer, required
    - `send_days` string[], required
    - `send_hour` integer, required
    - `time_zone` string, required
    - `active` boolean, required
    - `exclude_subscriber_sources` object[], required
      - `type` string, required
      - `ids` integer[], required
    - `email_count` integer
    - `subscriber_count` integer

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `403` — Returns a 403 with an error message if the current account is unauthorized to create a sequence
- `422` — Returns a 422 with an error message when one or more of the parameters were invalid

---

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