Update a sequence

curl --request PATCH \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "user_id": "507f1f77bcf86cd799439011",
  "throttle_max_adds_per_day": 25,
  "primary_reply_action": "pause",
  "primary_reply_pause_duration": 604800
}
'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}"

payload = {
    "user_id": "507f1f77bcf86cd799439011",
    "throttle_max_adds_per_day": 25,
    "primary_reply_action": "pause",
    "primary_reply_pause_duration": 604800
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    user_id: '507f1f77bcf86cd799439011',
    throttle_max_adds_per_day: 25,
    primary_reply_action: 'pause',
    primary_reply_pause_duration: 604800
  })
};

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'user_id' => '507f1f77bcf86cd799439011',
    'throttle_max_adds_per_day' => 25,
    'primary_reply_action' => 'pause',
    'primary_reply_pause_duration' => 604800
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}"

	payload := strings.NewReader("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"throttle_max_adds_per_day\": 25,\n  \"primary_reply_action\": \"pause\",\n  \"primary_reply_pause_duration\": 604800\n}")

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

	req.Header.Add("x-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))

}

HttpResponse<String> response = Unirest.patch("https://client-api.salesfinity.co/v2/sequencer/sequences/{id}")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"throttle_max_adds_per_day\": 25,\n  \"primary_reply_action\": \"pause\",\n  \"primary_reply_pause_duration\": 604800\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/sequences/{id}")

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

request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"throttle_max_adds_per_day\": 25,\n  \"primary_reply_action\": \"pause\",\n  \"primary_reply_pause_duration\": 604800\n}"

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

{
  "_id": "6650c1f2a9b8c7d6e5f40123",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "user": "64f1a2b3c4d5e6f7a8b9c0d2",
  "name": "Q4 outbound - VP Operations",
  "description": "Call, email, follow-up task over five days",
  "tags": [
    "outbound",
    "q4"
  ],
  "enabled": true,
  "enabled_at": "2026-09-02T14:05:11.000Z",
  "archived_at": null,
  "policy": null,
  "sequence_type": "interval",
  "throttle_max_adds_per_day": 25,
  "throttle_capacity": 300,
  "throttle_paused": false,
  "transactional": false,
  "primary_reply_action": "pause",
  "schedule": {
    "timezone_source": "prospect",
    "timezone": "America/New_York",
    "days_of_week": [
      1,
      2,
      3,
      4,
      5
    ],
    "start_hour": 8,
    "end_hour": 17
  },
  "email_account_ids": [],
  "track_opens": true,
  "track_links": true,
  "sequence_step_count": 3,
  "duration_in_days": 5,
  "automation_percentage": 33,
  "num_contacted_prospects": 118,
  "num_replied_prospects": 9,
  "reply_rate": 8,
  "deliver_count": 201,
  "open_count": 143,
  "click_count": 12,
  "reply_count": 10,
  "bounce_count": 3,
  "opt_out_count": 1,
  "failure_count": 0,
  "schedule_count": 260,
  "last_activity_at": "2026-10-02T16:41:00.000Z",
  "created_at": "2026-08-28T10:12:44.000Z",
  "updated_at": "2026-10-03T10:02:00.000Z",
  "primary_reply_pause_duration": 604800
}

{
  "message": "Fields cannot be null: description",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Only the sequence owner or a team admin can change this sequence",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "sequence_type cannot be changed while the sequence has steps",
  "error": "Conflict",
  "statusCode": 409,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "One of the mailboxes selected is not available to you. Pick from your own mailboxes or the shared ones.",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Sequences

Update a sequence

Changes a sequence’s settings. Send only the fields to change; the rest keep their values. Steps have their own endpoints.

user_id must be the sequence’s author, the team owner or a team admin. No field except policy may be null; send policy: null to fall back to the team default policy. sequence_type cannot change once the sequence has steps (409). schedule replaces the whole schedule, so send all five of its fields; once set, it cannot be removed, because schedule: null is refused.

Safe to retry: sending the same body again leaves the same result. Counts toward the Sequencer writes rate limit.

PATCH

sequencer

sequences

{id}

Update a sequence

curl --request PATCH \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "user_id": "507f1f77bcf86cd799439011",
  "throttle_max_adds_per_day": 25,
  "primary_reply_action": "pause",
  "primary_reply_pause_duration": 604800
}
'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}"

payload = {
    "user_id": "507f1f77bcf86cd799439011",
    "throttle_max_adds_per_day": 25,
    "primary_reply_action": "pause",
    "primary_reply_pause_duration": 604800
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    user_id: '507f1f77bcf86cd799439011',
    throttle_max_adds_per_day: 25,
    primary_reply_action: 'pause',
    primary_reply_pause_duration: 604800
  })
};

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'user_id' => '507f1f77bcf86cd799439011',
    'throttle_max_adds_per_day' => 25,
    'primary_reply_action' => 'pause',
    'primary_reply_pause_duration' => 604800
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}"

	payload := strings.NewReader("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"throttle_max_adds_per_day\": 25,\n  \"primary_reply_action\": \"pause\",\n  \"primary_reply_pause_duration\": 604800\n}")

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

	req.Header.Add("x-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))

}

HttpResponse<String> response = Unirest.patch("https://client-api.salesfinity.co/v2/sequencer/sequences/{id}")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"throttle_max_adds_per_day\": 25,\n  \"primary_reply_action\": \"pause\",\n  \"primary_reply_pause_duration\": 604800\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/sequences/{id}")

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

request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"throttle_max_adds_per_day\": 25,\n  \"primary_reply_action\": \"pause\",\n  \"primary_reply_pause_duration\": 604800\n}"

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

{
  "_id": "6650c1f2a9b8c7d6e5f40123",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "user": "64f1a2b3c4d5e6f7a8b9c0d2",
  "name": "Q4 outbound - VP Operations",
  "description": "Call, email, follow-up task over five days",
  "tags": [
    "outbound",
    "q4"
  ],
  "enabled": true,
  "enabled_at": "2026-09-02T14:05:11.000Z",
  "archived_at": null,
  "policy": null,
  "sequence_type": "interval",
  "throttle_max_adds_per_day": 25,
  "throttle_capacity": 300,
  "throttle_paused": false,
  "transactional": false,
  "primary_reply_action": "pause",
  "schedule": {
    "timezone_source": "prospect",
    "timezone": "America/New_York",
    "days_of_week": [
      1,
      2,
      3,
      4,
      5
    ],
    "start_hour": 8,
    "end_hour": 17
  },
  "email_account_ids": [],
  "track_opens": true,
  "track_links": true,
  "sequence_step_count": 3,
  "duration_in_days": 5,
  "automation_percentage": 33,
  "num_contacted_prospects": 118,
  "num_replied_prospects": 9,
  "reply_rate": 8,
  "deliver_count": 201,
  "open_count": 143,
  "click_count": 12,
  "reply_count": 10,
  "bounce_count": 3,
  "opt_out_count": 1,
  "failure_count": 0,
  "schedule_count": 260,
  "last_activity_at": "2026-10-02T16:41:00.000Z",
  "created_at": "2026-08-28T10:12:44.000Z",
  "updated_at": "2026-10-03T10:02:00.000Z",
  "primary_reply_pause_duration": 604800
}

{
  "message": "Fields cannot be null: description",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Only the sequence owner or a team admin can change this sequence",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "sequence_type cannot be changed while the sequence has steps",
  "error": "Conflict",
  "statusCode": 409,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "One of the mailboxes selected is not available to you. Pick from your own mailboxes or the shared ones.",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Changes a sequence’s settings. Send only the fields you want to change; everything else keeps its value. Steps have their own endpoints. user_id must be the sequence’s author, the team owner or a team admin.

Example

Cap new adds at 25 a day and pause an enrollment for a week when the prospect replies:

curl -X PATCH https://client-api.salesfinity.co/v2/sequencer/sequences/6650c1f2a9b8c7d6e5f40123 \
  -H 'x-api-key: YOUR_API_KEY' -H 'content-type: application/json' \
  -d '{
    "user_id": "507f1f77bcf86cd799439011",
    "throttle_max_adds_per_day": 25,
    "primary_reply_action": "pause",
    "primary_reply_pause_duration": 604800
  }'

Rules

No null except on policy. "policy": null detaches the sequence’s own policy so it falls back to the team default. Any other field sent as null is refused with 400.
schedule replaces the whole schedule. Send all five fields. Once a sequence has a schedule it cannot be removed through the API, because "schedule": null is refused.
sequence_type cannot change while the sequence has steps (409). Delete the steps first, or create a new sequence.
Mailboxes. A member who is not a team admin can only set email_account_ids to shared mailboxes or mailboxes assigned to them (422 otherwise).

Sending the same body twice leaves the same result, so a retry is safe without an Idempotency-Key.

When it fails

Status	When
400	A field fails validation, a field other than `policy` is `null`, or the id is malformed.
403	The API key is invalid, `user_id` is not an active team member or has no active plan or seat, or `user_id` is not the author, the team owner or an admin.
404	The sequence is not on your team, or `policy` names a policy that is not.
409	`sequence_type` was changed on a sequence that has steps.
422	`email_account_ids` includes a mailbox `user_id` may not send from.

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

string

required

24-character sequence id.

Body

application/json

user_id

string

required

The team member making the change. Must be the sequence's author, the team owner or a team admin, and have an active plan or seat. A 24-character hexadecimal ID.

Example:

"507f1f77bcf86cd799439011"

name

string

Sequence name, 1 to 200 characters.

Maximum string length: 200

Example:

"Q4 outbound - VP Operations"

description

string

Up to 2,000 characters.

Maximum string length: 2000

Response

The updated sequence. can_manage is not included.

A Sequencer sequence (a cadence). can_manage is returned by list and get only; step_type_counts and enrollment_counts by list only.

_id

string

24-character hexadecimal id.

Example:

"507f1f77bcf86cd799439011"

team

string

The team that owns the sequence (24-character id).

name

string

Sequence name.

description

string | null

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Update a sequence

Example

Rules

When it fails

Authorizations

Path Parameters

Body

Response

​Example

​Rules

​When it fails

Authorizations

Path Parameters

Body

Response

Example

Rules

When it fails