Create a sequence

curl --request POST \
  --url https://api.kit.com/v4/sequences \
  --header 'Content-Type: application/json' \
  --header 'X-Kit-Api-Key: <api-key>' \
  --data '
{
  "name": "Full Series",
  "email_address": "joe1150@ck.lol",
  "email_template_id": 38,
  "send_days": [
    "monday",
    "wednesday",
    "friday"
  ],
  "send_hour": 9,
  "time_zone": "America/Los_Angeles",
  "active": true,
  "repeat": true,
  "hold": true,
  "exclude_subscriber_sources": [
    {
      "type": "tag",
      "ids": [
        3
      ]
    },
    {
      "type": "sequence",
      "ids": [
        30
      ]
    }
  ]
}
'

require 'uri'
require 'net/http'

url = URI("https://api.kit.com/v4/sequences")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Kit-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Full Series\",\n  \"email_address\": \"joe1150@ck.lol\",\n  \"email_template_id\": 38,\n  \"send_days\": [\n    \"monday\",\n    \"wednesday\",\n    \"friday\"\n  ],\n  \"send_hour\": 9,\n  \"time_zone\": \"America/Los_Angeles\",\n  \"active\": true,\n  \"repeat\": true,\n  \"hold\": true,\n  \"exclude_subscriber_sources\": [\n    {\n      \"type\": \"tag\",\n      \"ids\": [\n        3\n      ]\n    },\n    {\n      \"type\": \"sequence\",\n      \"ids\": [\n        30\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

const options = {
  method: 'POST',
  headers: {'X-Kit-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Full Series',
    email_address: 'joe1150@ck.lol',
    email_template_id: 38,
    send_days: ['monday', 'wednesday', 'friday'],
    send_hour: 9,
    time_zone: 'America/Los_Angeles',
    active: true,
    repeat: true,
    hold: true,
    exclude_subscriber_sources: [{type: 'tag', ids: [3]}, {type: 'sequence', ids: [30]}]
  })
};

fetch('https://api.kit.com/v4/sequences', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kit.com/v4/sequences"

	payload := strings.NewReader("{\n  \"name\": \"Full Series\",\n  \"email_address\": \"joe1150@ck.lol\",\n  \"email_template_id\": 38,\n  \"send_days\": [\n    \"monday\",\n    \"wednesday\",\n    \"friday\"\n  ],\n  \"send_hour\": 9,\n  \"time_zone\": \"America/Los_Angeles\",\n  \"active\": true,\n  \"repeat\": true,\n  \"hold\": true,\n  \"exclude_subscriber_sources\": [\n    {\n      \"type\": \"tag\",\n      \"ids\": [\n        3\n      ]\n    },\n    {\n      \"type\": \"sequence\",\n      \"ids\": [\n        30\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Kit-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kit.com/v4/sequences",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Full Series',
    'email_address' => 'joe1150@ck.lol',
    'email_template_id' => 38,
    'send_days' => [
        'monday',
        'wednesday',
        'friday'
    ],
    'send_hour' => 9,
    'time_zone' => 'America/Los_Angeles',
    'active' => true,
    'repeat' => true,
    'hold' => true,
    'exclude_subscriber_sources' => [
        [
                'type' => 'tag',
                'ids' => [
                                3
                ]
        ],
        [
                'type' => 'sequence',
                'ids' => [
                                30
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Kit-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://api.kit.com/v4/sequences"

payload = {
    "name": "Full Series",
    "email_address": "joe1150@ck.lol",
    "email_template_id": 38,
    "send_days": ["monday", "wednesday", "friday"],
    "send_hour": 9,
    "time_zone": "America/Los_Angeles",
    "active": True,
    "repeat": True,
    "hold": True,
    "exclude_subscriber_sources": [
        {
            "type": "tag",
            "ids": [3]
        },
        {
            "type": "sequence",
            "ids": [30]
        }
    ]
}
headers = {
    "X-Kit-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "sequence": {
    "id": 31,
    "name": "Full Series",
    "hold": true,
    "repeat": true,
    "created_at": "2026-07-28T03:01:49Z",
    "updated_at": "2026-07-28T03:01:49Z",
    "email_address": "joe1150@ck.lol",
    "email_template_id": 38,
    "send_days": [
      "monday",
      "wednesday",
      "friday"
    ],
    "send_hour": 9,
    "time_zone": "America/Los_Angeles",
    "active": true,
    "exclude_subscriber_sources": [
      {
        "type": "sequence",
        "ids": [
          30
        ]
      },
      {
        "type": "tag",
        "ids": [
          3
        ]
      }
    ],
    "email_count": 0,
    "subscriber_count": 0
  }
}

{
  "errors": [
    "The access token is invalid"
  ]
}

{
  "errors": [
    "You do not have sufficient permissions to access this resource. Please contact support."
  ]
}

{
  "errors": [
    "send_hour must be an integer between 0 and 23"
  ]
}

Sequences

Create a sequence

Creates an empty sequence — the container that holds sequence emails. After creating the shell, use 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.

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, restarting a sequence, and holding subscribers in evergreen sequences.

POST

sequences

Create a sequence

curl --request POST \
  --url https://api.kit.com/v4/sequences \
  --header 'Content-Type: application/json' \
  --header 'X-Kit-Api-Key: <api-key>' \
  --data '
{
  "name": "Full Series",
  "email_address": "joe1150@ck.lol",
  "email_template_id": 38,
  "send_days": [
    "monday",
    "wednesday",
    "friday"
  ],
  "send_hour": 9,
  "time_zone": "America/Los_Angeles",
  "active": true,
  "repeat": true,
  "hold": true,
  "exclude_subscriber_sources": [
    {
      "type": "tag",
      "ids": [
        3
      ]
    },
    {
      "type": "sequence",
      "ids": [
        30
      ]
    }
  ]
}
'

require 'uri'
require 'net/http'

url = URI("https://api.kit.com/v4/sequences")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Kit-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Full Series\",\n  \"email_address\": \"joe1150@ck.lol\",\n  \"email_template_id\": 38,\n  \"send_days\": [\n    \"monday\",\n    \"wednesday\",\n    \"friday\"\n  ],\n  \"send_hour\": 9,\n  \"time_zone\": \"America/Los_Angeles\",\n  \"active\": true,\n  \"repeat\": true,\n  \"hold\": true,\n  \"exclude_subscriber_sources\": [\n    {\n      \"type\": \"tag\",\n      \"ids\": [\n        3\n      ]\n    },\n    {\n      \"type\": \"sequence\",\n      \"ids\": [\n        30\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

const options = {
  method: 'POST',
  headers: {'X-Kit-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Full Series',
    email_address: 'joe1150@ck.lol',
    email_template_id: 38,
    send_days: ['monday', 'wednesday', 'friday'],
    send_hour: 9,
    time_zone: 'America/Los_Angeles',
    active: true,
    repeat: true,
    hold: true,
    exclude_subscriber_sources: [{type: 'tag', ids: [3]}, {type: 'sequence', ids: [30]}]
  })
};

fetch('https://api.kit.com/v4/sequences', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kit.com/v4/sequences"

	payload := strings.NewReader("{\n  \"name\": \"Full Series\",\n  \"email_address\": \"joe1150@ck.lol\",\n  \"email_template_id\": 38,\n  \"send_days\": [\n    \"monday\",\n    \"wednesday\",\n    \"friday\"\n  ],\n  \"send_hour\": 9,\n  \"time_zone\": \"America/Los_Angeles\",\n  \"active\": true,\n  \"repeat\": true,\n  \"hold\": true,\n  \"exclude_subscriber_sources\": [\n    {\n      \"type\": \"tag\",\n      \"ids\": [\n        3\n      ]\n    },\n    {\n      \"type\": \"sequence\",\n      \"ids\": [\n        30\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Kit-Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kit.com/v4/sequences",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Full Series',
    'email_address' => 'joe1150@ck.lol',
    'email_template_id' => 38,
    'send_days' => [
        'monday',
        'wednesday',
        'friday'
    ],
    'send_hour' => 9,
    'time_zone' => 'America/Los_Angeles',
    'active' => true,
    'repeat' => true,
    'hold' => true,
    'exclude_subscriber_sources' => [
        [
                'type' => 'tag',
                'ids' => [
                                3
                ]
        ],
        [
                'type' => 'sequence',
                'ids' => [
                                30
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Kit-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://api.kit.com/v4/sequences"

payload = {
    "name": "Full Series",
    "email_address": "joe1150@ck.lol",
    "email_template_id": 38,
    "send_days": ["monday", "wednesday", "friday"],
    "send_hour": 9,
    "time_zone": "America/Los_Angeles",
    "active": True,
    "repeat": True,
    "hold": True,
    "exclude_subscriber_sources": [
        {
            "type": "tag",
            "ids": [3]
        },
        {
            "type": "sequence",
            "ids": [30]
        }
    ]
}
headers = {
    "X-Kit-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "sequence": {
    "id": 31,
    "name": "Full Series",
    "hold": true,
    "repeat": true,
    "created_at": "2026-07-28T03:01:49Z",
    "updated_at": "2026-07-28T03:01:49Z",
    "email_address": "joe1150@ck.lol",
    "email_template_id": 38,
    "send_days": [
      "monday",
      "wednesday",
      "friday"
    ],
    "send_hour": 9,
    "time_zone": "America/Los_Angeles",
    "active": true,
    "exclude_subscriber_sources": [
      {
        "type": "sequence",
        "ids": [
          30
        ]
      },
      {
        "type": "tag",
        "ids": [
          3
        ]
      }
    ],
    "email_count": 0,
    "subscriber_count": 0
  }
}

{
  "errors": [
    "The access token is invalid"
  ]
}

{
  "errors": [
    "You do not have sufficient permissions to access this resource. Please contact support."
  ]
}

{
  "errors": [
    "send_hour must be an integer between 0 and 23"
  ]
}

Authorizations

X-Kit-Api-Key

string

header

required

Authenticate API requests via an API Key

Body

application/json

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.

Show child attributes

Response

Creates a new sequence

sequence

object

required

Show child attributes

Getting started

Guides

Webhooks

Endpoints

Create a sequence

Authorizations

Body

Response