Create or update a sequence.

curl --request POST \
  --url https://api.parallellabs.app/api/v0/sequences \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "confirmDeleteAllSteps": true,
  "crmIntegrationId": "<string>",
  "crmSyncEnabled": true,
  "description": "<string>",
  "id": "<string>",
  "includeUnsubscribeText": true,
  "linkedinIntegrationIds": [
    "<string>"
  ],
  "name": "<string>",
  "notificationUserIds": [
    "<string>"
  ],
  "partial": true,
  "phoneIntegrationIds": [
    "<string>"
  ],
  "phoneNumbers": [
    "<string>"
  ],
  "senderProfileId": "<string>",
  "senderProfileIds": [
    "<string>"
  ],
  "steps": [
    {}
  ],
  "unsubscribeText": "<string>",
  "voiceId": "<string>"
}
'

import requests

url = "https://api.parallellabs.app/api/v0/sequences"

payload = {
    "confirmDeleteAllSteps": True,
    "crmIntegrationId": "<string>",
    "crmSyncEnabled": True,
    "description": "<string>",
    "id": "<string>",
    "includeUnsubscribeText": True,
    "linkedinIntegrationIds": ["<string>"],
    "name": "<string>",
    "notificationUserIds": ["<string>"],
    "partial": True,
    "phoneIntegrationIds": ["<string>"],
    "phoneNumbers": ["<string>"],
    "senderProfileId": "<string>",
    "senderProfileIds": ["<string>"],
    "steps": [{}],
    "unsubscribeText": "<string>",
    "voiceId": "<string>"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    confirmDeleteAllSteps: true,
    crmIntegrationId: '<string>',
    crmSyncEnabled: true,
    description: '<string>',
    id: '<string>',
    includeUnsubscribeText: true,
    linkedinIntegrationIds: ['<string>'],
    name: '<string>',
    notificationUserIds: ['<string>'],
    partial: true,
    phoneIntegrationIds: ['<string>'],
    phoneNumbers: ['<string>'],
    senderProfileId: '<string>',
    senderProfileIds: ['<string>'],
    steps: [{}],
    unsubscribeText: '<string>',
    voiceId: '<string>'
  })
};

fetch('https://api.parallellabs.app/api/v0/sequences', 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://api.parallellabs.app/api/v0/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([
    'confirmDeleteAllSteps' => true,
    'crmIntegrationId' => '<string>',
    'crmSyncEnabled' => true,
    'description' => '<string>',
    'id' => '<string>',
    'includeUnsubscribeText' => true,
    'linkedinIntegrationIds' => [
        '<string>'
    ],
    'name' => '<string>',
    'notificationUserIds' => [
        '<string>'
    ],
    'partial' => true,
    'phoneIntegrationIds' => [
        '<string>'
    ],
    'phoneNumbers' => [
        '<string>'
    ],
    'senderProfileId' => '<string>',
    'senderProfileIds' => [
        '<string>'
    ],
    'steps' => [
        [
                
        ]
    ],
    'unsubscribeText' => '<string>',
    'voiceId' => '<string>'
  ]),
  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://api.parallellabs.app/api/v0/sequences"

	payload := strings.NewReader("{\n  \"confirmDeleteAllSteps\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"name\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ],\n  \"partial\": true,\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"steps\": [\n    {}\n  ],\n  \"unsubscribeText\": \"<string>\",\n  \"voiceId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.parallellabs.app/api/v0/sequences")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"confirmDeleteAllSteps\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"name\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ],\n  \"partial\": true,\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"steps\": [\n    {}\n  ],\n  \"unsubscribeText\": \"<string>\",\n  \"voiceId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.parallellabs.app/api/v0/sequences")

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

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"confirmDeleteAllSteps\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"name\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ],\n  \"partial\": true,\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"steps\": [\n    {}\n  ],\n  \"unsubscribeText\": \"<string>\",\n  \"voiceId\": \"<string>\"\n}"

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

{
  "sequence": {
    "created": "<string>",
    "description": "<string>",
    "id": "<string>",
    "includeUnsubscribeText": true,
    "memberCount": 123,
    "name": "<string>",
    "status": "<string>",
    "steps": [
      {
        "abTestEnabled": true,
        "abTestName": "<string>",
        "actionParameters": {},
        "actionType": "<string>",
        "aiPersonalized": true,
        "aiPersonalizedInstructions": "<string>",
        "autoAgentParameters": {
          "abilities": [
            "<string>"
          ],
          "agentId": "<string>",
          "autoAgentChannel": "<string>",
          "goal": "<string>",
          "maxResponseDelayMinutes": 123,
          "maxSteps": 123,
          "minResponseDelayMinutes": 123,
          "useSenderProfileAgent": true
        },
        "content": "<string>",
        "created_date": "<string>",
        "daysAfterPrevious": 123,
        "id": "<string>",
        "order": 123,
        "platform": "<string>",
        "schedulingIntegrationId": "<string>",
        "senderProfile": "<string>",
        "sequenceId": "<string>",
        "stepName": "<string>",
        "subject": "<string>",
        "trackCalendarBooking": true,
        "updated_date": "<string>",
        "variants": [
          {}
        ]
      }
    ],
    "unsubscribeText": "<string>",
    "updated": "<string>"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Sequences

Create or update a sequence.

By default (``partial`` omitted or true) only the fields present in the body are updated and every omitted field is left untouched -- this is the recommended behavior for AI agents so a targeted edit never resets unrelated settings. Send ``partial: false`` to do a full replace where omitted fields fall back to their defaults (the frontend does this). Including ``steps`` replaces the full step list; to change a single step, prefer the /sequences/<id>/steps endpoints. A ``steps`` array that drops every existing step is rejected unless ``confirmDeleteAllSteps: true`` is also sent.

POST

api

sequences

curl --request POST \
  --url https://api.parallellabs.app/api/v0/sequences \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "confirmDeleteAllSteps": true,
  "crmIntegrationId": "<string>",
  "crmSyncEnabled": true,
  "description": "<string>",
  "id": "<string>",
  "includeUnsubscribeText": true,
  "linkedinIntegrationIds": [
    "<string>"
  ],
  "name": "<string>",
  "notificationUserIds": [
    "<string>"
  ],
  "partial": true,
  "phoneIntegrationIds": [
    "<string>"
  ],
  "phoneNumbers": [
    "<string>"
  ],
  "senderProfileId": "<string>",
  "senderProfileIds": [
    "<string>"
  ],
  "steps": [
    {}
  ],
  "unsubscribeText": "<string>",
  "voiceId": "<string>"
}
'

import requests

url = "https://api.parallellabs.app/api/v0/sequences"

payload = {
    "confirmDeleteAllSteps": True,
    "crmIntegrationId": "<string>",
    "crmSyncEnabled": True,
    "description": "<string>",
    "id": "<string>",
    "includeUnsubscribeText": True,
    "linkedinIntegrationIds": ["<string>"],
    "name": "<string>",
    "notificationUserIds": ["<string>"],
    "partial": True,
    "phoneIntegrationIds": ["<string>"],
    "phoneNumbers": ["<string>"],
    "senderProfileId": "<string>",
    "senderProfileIds": ["<string>"],
    "steps": [{}],
    "unsubscribeText": "<string>",
    "voiceId": "<string>"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    confirmDeleteAllSteps: true,
    crmIntegrationId: '<string>',
    crmSyncEnabled: true,
    description: '<string>',
    id: '<string>',
    includeUnsubscribeText: true,
    linkedinIntegrationIds: ['<string>'],
    name: '<string>',
    notificationUserIds: ['<string>'],
    partial: true,
    phoneIntegrationIds: ['<string>'],
    phoneNumbers: ['<string>'],
    senderProfileId: '<string>',
    senderProfileIds: ['<string>'],
    steps: [{}],
    unsubscribeText: '<string>',
    voiceId: '<string>'
  })
};

fetch('https://api.parallellabs.app/api/v0/sequences', 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://api.parallellabs.app/api/v0/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([
    'confirmDeleteAllSteps' => true,
    'crmIntegrationId' => '<string>',
    'crmSyncEnabled' => true,
    'description' => '<string>',
    'id' => '<string>',
    'includeUnsubscribeText' => true,
    'linkedinIntegrationIds' => [
        '<string>'
    ],
    'name' => '<string>',
    'notificationUserIds' => [
        '<string>'
    ],
    'partial' => true,
    'phoneIntegrationIds' => [
        '<string>'
    ],
    'phoneNumbers' => [
        '<string>'
    ],
    'senderProfileId' => '<string>',
    'senderProfileIds' => [
        '<string>'
    ],
    'steps' => [
        [
                
        ]
    ],
    'unsubscribeText' => '<string>',
    'voiceId' => '<string>'
  ]),
  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://api.parallellabs.app/api/v0/sequences"

	payload := strings.NewReader("{\n  \"confirmDeleteAllSteps\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"name\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ],\n  \"partial\": true,\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"steps\": [\n    {}\n  ],\n  \"unsubscribeText\": \"<string>\",\n  \"voiceId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.parallellabs.app/api/v0/sequences")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"confirmDeleteAllSteps\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"name\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ],\n  \"partial\": true,\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"steps\": [\n    {}\n  ],\n  \"unsubscribeText\": \"<string>\",\n  \"voiceId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.parallellabs.app/api/v0/sequences")

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

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"confirmDeleteAllSteps\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"name\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ],\n  \"partial\": true,\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"steps\": [\n    {}\n  ],\n  \"unsubscribeText\": \"<string>\",\n  \"voiceId\": \"<string>\"\n}"

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

{
  "sequence": {
    "created": "<string>",
    "description": "<string>",
    "id": "<string>",
    "includeUnsubscribeText": true,
    "memberCount": 123,
    "name": "<string>",
    "status": "<string>",
    "steps": [
      {
        "abTestEnabled": true,
        "abTestName": "<string>",
        "actionParameters": {},
        "actionType": "<string>",
        "aiPersonalized": true,
        "aiPersonalizedInstructions": "<string>",
        "autoAgentParameters": {
          "abilities": [
            "<string>"
          ],
          "agentId": "<string>",
          "autoAgentChannel": "<string>",
          "goal": "<string>",
          "maxResponseDelayMinutes": 123,
          "maxSteps": 123,
          "minResponseDelayMinutes": 123,
          "useSenderProfileAgent": true
        },
        "content": "<string>",
        "created_date": "<string>",
        "daysAfterPrevious": 123,
        "id": "<string>",
        "order": 123,
        "platform": "<string>",
        "schedulingIntegrationId": "<string>",
        "senderProfile": "<string>",
        "sequenceId": "<string>",
        "stepName": "<string>",
        "subject": "<string>",
        "trackCalendarBooking": true,
        "updated_date": "<string>",
        "variants": [
          {}
        ]
      }
    ],
    "unsubscribeText": "<string>",
    "updated": "<string>"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

X-API-Key

string

header

required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Body

application/json

Sequence data

Request body for creating or updating a sequence

confirmDeleteAllSteps

boolean

Safety flag. Required to be true if "steps" is provided but keeps none of the existing steps (e.g. an empty array); otherwise the request is rejected to prevent accidentally wiping every step.

crmIntegrationId

string

CRM integration ID to sync to (used only when crmSyncEnabled is true). To find valid IDs, call crm_getCrmIntegrations.

crmSyncEnabled

boolean

Enable syncing replies/outcomes to a CRM. When true, also set crmIntegrationId.

description

string

Sequence description

string

Sequence ID. Provide to update an existing sequence; omit to create a new one.

includeUnsubscribeText

boolean

Append a custom opt-out line to the end of each email, where the unsubscribe link goes. Independent of includeUnsubscribeLink — use it in place of or in addition to the link, and it is also included on text-only emails (which have no link). When true and unsubscribeText is blank, the default line is used. Defaults to false.

linkedinIntegrationIds

string[]

FALLBACK ONLY. LinkedIn account integration IDs used for a member whose selected sender profile has no linkedinIntegrationId of its own. If your sender profiles already have LinkedIn attached, leave this empty. To find valid IDs, call integrations_getIntegrationsByType with path integration_type=browser_session and query type=linkedin_login.

name

string

Sequence name. Required when creating (no id); optional on update.

notificationUserIds

string[]

Company user IDs (uids) who should receive sequence notifications. To find valid IDs, call company_users_getCompanyUsers.

partial

boolean

Update only the fields present in this body and leave all omitted fields untouched. Recommended for AI agents making targeted edits so they never reset unrelated settings. Ignored when creating a new sequence. Defaults to false (full replace).

phoneIntegrationIds

string[]

FALLBACK ONLY. Twilio/phone integration IDs for SMS/voice steps, used when the selected sender profile has no phoneIntegrationId. If your sender profiles already have phone attached, leave this empty. To find valid IDs, call integrations_getIntegrationsByType with path integration_type=sms.

phoneNumbers

string[]

FALLBACK ONLY. Sending phone numbers (E.164) paired with the fallback phoneIntegrationIds, used when the sender profile has no phone number. To find available numbers for a phone integration, call integrations_getTwilioPhoneNumbers with that integration_id.

senderProfileId

string

Deprecated single sender profile ID; prefer senderProfileIds. To find valid IDs, call sequences_listProfiles.

senderProfileIds

string[]

PRIMARY channel configuration. Sender profile IDs to send as; each profile already carries its own email account, LinkedIn account, phone integration + number, voice, and agent, so usually this is the only channel field you need to set. To find valid IDs (and to see which channels each profile already has), call sequences_listProfiles. To attach a missing channel, edit the sender profile via sequences_updateProfile rather than setting the sequence-level fallbacks below.

steps

object[]

Array of sequence step configurations. WARNING: this REPLACES the full step list — any existing step not included here is removed. Omit this key entirely to leave steps unchanged. To edit, add, or delete a single step, prefer the /sequences//steps endpoints instead.

unsubscribeText

string

The custom opt-out text shown when includeUnsubscribeText is true. Leave blank to use the default: 'If this is not relevant, simply reply "stop".' Has no effect unless includeUnsubscribeText is true.

voiceId

string

FALLBACK ONLY. Voice ID for voice-message steps, used when the selected sender profile has no voiceId. To find valid IDs, call voices_listVoices.

Response

Created sequence

Sequence response

sequence

object

Sequence object

Show child attributes

List all sequences for the current company.Get all executions across all sequences for a company.

⌘I

Agents

Keys

Audio

Browser

Chat

Projects

Companies

Employees

Memories

Departments

Company Users

Content

Integrations

Documentation

Documents

Images

Inbox

Landing Pages

Leads

Lists

Marketing Campaigns

Mcp

Monitors

Models

Organizations

Usage

People

Content Research

Sequences

Support

Tags

Video

Voices

Create or update a sequence.

Authorizations

Body

Response