curl --request PUT \
--url https://api.kit.com/v4/sequences/{id} \
--header 'Content-Type: application/json' \
--header 'X-Kit-Api-Key: <api-key>' \
--data '
{
"name": "New Name",
"email_address": "joe1180@ck.lol",
"email_template_id": 40,
"send_days": [
"tuesday",
"thursday"
],
"send_hour": 14,
"time_zone": "America/Chicago",
"active": false,
"repeat": true,
"hold": true,
"exclude_subscriber_sources": [
{
"type": "tag",
"ids": [
4
]
},
{
"type": "sequence",
"ids": [
49
]
}
]
}
'require 'uri'
require 'net/http'
url = URI("https://api.kit.com/v4/sequences/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Kit-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"New Name\",\n \"email_address\": \"joe1180@ck.lol\",\n \"email_template_id\": 40,\n \"send_days\": [\n \"tuesday\",\n \"thursday\"\n ],\n \"send_hour\": 14,\n \"time_zone\": \"America/Chicago\",\n \"active\": false,\n \"repeat\": true,\n \"hold\": true,\n \"exclude_subscriber_sources\": [\n {\n \"type\": \"tag\",\n \"ids\": [\n 4\n ]\n },\n {\n \"type\": \"sequence\",\n \"ids\": [\n 49\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_bodyconst options = {
method: 'PUT',
headers: {'X-Kit-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'New Name',
email_address: 'joe1180@ck.lol',
email_template_id: 40,
send_days: ['tuesday', 'thursday'],
send_hour: 14,
time_zone: 'America/Chicago',
active: false,
repeat: true,
hold: true,
exclude_subscriber_sources: [{type: 'tag', ids: [4]}, {type: 'sequence', ids: [49]}]
})
};
fetch('https://api.kit.com/v4/sequences/{id}', 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/{id}"
payload := strings.NewReader("{\n \"name\": \"New Name\",\n \"email_address\": \"joe1180@ck.lol\",\n \"email_template_id\": 40,\n \"send_days\": [\n \"tuesday\",\n \"thursday\"\n ],\n \"send_hour\": 14,\n \"time_zone\": \"America/Chicago\",\n \"active\": false,\n \"repeat\": true,\n \"hold\": true,\n \"exclude_subscriber_sources\": [\n {\n \"type\": \"tag\",\n \"ids\": [\n 4\n ]\n },\n {\n \"type\": \"sequence\",\n \"ids\": [\n 49\n ]\n }\n ]\n}")
req, _ := http.NewRequest("PUT", 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'New Name',
'email_address' => 'joe1180@ck.lol',
'email_template_id' => 40,
'send_days' => [
'tuesday',
'thursday'
],
'send_hour' => 14,
'time_zone' => 'America/Chicago',
'active' => false,
'repeat' => true,
'hold' => true,
'exclude_subscriber_sources' => [
[
'type' => 'tag',
'ids' => [
4
]
],
[
'type' => 'sequence',
'ids' => [
49
]
]
]
]),
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/{id}"
payload = {
"name": "New Name",
"email_address": "joe1180@ck.lol",
"email_template_id": 40,
"send_days": ["tuesday", "thursday"],
"send_hour": 14,
"time_zone": "America/Chicago",
"active": False,
"repeat": True,
"hold": True,
"exclude_subscriber_sources": [
{
"type": "tag",
"ids": [4]
},
{
"type": "sequence",
"ids": [49]
}
]
}
headers = {
"X-Kit-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"sequence": {
"id": 50,
"name": "New Name",
"hold": true,
"repeat": true,
"created_at": "2026-07-28T03:01:51Z",
"updated_at": "2026-07-28T03:01:52Z",
"email_address": "joe1180@ck.lol",
"email_template_id": 40,
"send_days": [
"tuesday",
"thursday"
],
"send_hour": 14,
"time_zone": "America/Chicago",
"active": false,
"exclude_subscriber_sources": [
{
"type": "sequence",
"ids": [
49
]
},
{
"type": "tag",
"ids": [
4
]
}
],
"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": [
"Not Found"
]
}{
"errors": [
"name can't be blank"
]
}Update a sequence
Updates any sequence settings — name, email_address, schedule (send_days, send_hour, time_zone), email_template_id, exclude_subscriber_sources, or the active / repeat / hold flags. Only fields included in the request body change; everything else is preserved.
Some changes have user-visible side effects on subscribers already in the sequence:
Note: flipping active from false to true resumes delivery for queued subscribers. Flipping it back to false pauses the sequence — subscribers stay in their current position but no new emails are sent until it’s reactivated.
Note: changing the schedule (send_days, send_hour, or time_zone) only affects future sends. It does not retroactively reschedule emails already queued for delivery.
Warning: turning off repeat while subscribers are mid-sequence does not stop them from finishing — but they won’t be re-eligible to start over after completing.
See Create a sequence for the full sequence model and what each field controls.
curl --request PUT \
--url https://api.kit.com/v4/sequences/{id} \
--header 'Content-Type: application/json' \
--header 'X-Kit-Api-Key: <api-key>' \
--data '
{
"name": "New Name",
"email_address": "joe1180@ck.lol",
"email_template_id": 40,
"send_days": [
"tuesday",
"thursday"
],
"send_hour": 14,
"time_zone": "America/Chicago",
"active": false,
"repeat": true,
"hold": true,
"exclude_subscriber_sources": [
{
"type": "tag",
"ids": [
4
]
},
{
"type": "sequence",
"ids": [
49
]
}
]
}
'require 'uri'
require 'net/http'
url = URI("https://api.kit.com/v4/sequences/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Kit-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"New Name\",\n \"email_address\": \"joe1180@ck.lol\",\n \"email_template_id\": 40,\n \"send_days\": [\n \"tuesday\",\n \"thursday\"\n ],\n \"send_hour\": 14,\n \"time_zone\": \"America/Chicago\",\n \"active\": false,\n \"repeat\": true,\n \"hold\": true,\n \"exclude_subscriber_sources\": [\n {\n \"type\": \"tag\",\n \"ids\": [\n 4\n ]\n },\n {\n \"type\": \"sequence\",\n \"ids\": [\n 49\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_bodyconst options = {
method: 'PUT',
headers: {'X-Kit-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'New Name',
email_address: 'joe1180@ck.lol',
email_template_id: 40,
send_days: ['tuesday', 'thursday'],
send_hour: 14,
time_zone: 'America/Chicago',
active: false,
repeat: true,
hold: true,
exclude_subscriber_sources: [{type: 'tag', ids: [4]}, {type: 'sequence', ids: [49]}]
})
};
fetch('https://api.kit.com/v4/sequences/{id}', 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/{id}"
payload := strings.NewReader("{\n \"name\": \"New Name\",\n \"email_address\": \"joe1180@ck.lol\",\n \"email_template_id\": 40,\n \"send_days\": [\n \"tuesday\",\n \"thursday\"\n ],\n \"send_hour\": 14,\n \"time_zone\": \"America/Chicago\",\n \"active\": false,\n \"repeat\": true,\n \"hold\": true,\n \"exclude_subscriber_sources\": [\n {\n \"type\": \"tag\",\n \"ids\": [\n 4\n ]\n },\n {\n \"type\": \"sequence\",\n \"ids\": [\n 49\n ]\n }\n ]\n}")
req, _ := http.NewRequest("PUT", 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'New Name',
'email_address' => 'joe1180@ck.lol',
'email_template_id' => 40,
'send_days' => [
'tuesday',
'thursday'
],
'send_hour' => 14,
'time_zone' => 'America/Chicago',
'active' => false,
'repeat' => true,
'hold' => true,
'exclude_subscriber_sources' => [
[
'type' => 'tag',
'ids' => [
4
]
],
[
'type' => 'sequence',
'ids' => [
49
]
]
]
]),
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/{id}"
payload = {
"name": "New Name",
"email_address": "joe1180@ck.lol",
"email_template_id": 40,
"send_days": ["tuesday", "thursday"],
"send_hour": 14,
"time_zone": "America/Chicago",
"active": False,
"repeat": True,
"hold": True,
"exclude_subscriber_sources": [
{
"type": "tag",
"ids": [4]
},
{
"type": "sequence",
"ids": [49]
}
]
}
headers = {
"X-Kit-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"sequence": {
"id": 50,
"name": "New Name",
"hold": true,
"repeat": true,
"created_at": "2026-07-28T03:01:51Z",
"updated_at": "2026-07-28T03:01:52Z",
"email_address": "joe1180@ck.lol",
"email_template_id": 40,
"send_days": [
"tuesday",
"thursday"
],
"send_hour": 14,
"time_zone": "America/Chicago",
"active": false,
"exclude_subscriber_sources": [
{
"type": "sequence",
"ids": [
49
]
},
{
"type": "tag",
"ids": [
4
]
}
],
"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": [
"Not Found"
]
}{
"errors": [
"name can't be blank"
]
}Authorizations
Body
Was this page helpful?