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 '
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "includeUnsubscribeText": true,
  "unsubscribeText": "<string>",
  "partial": true,
  "steps": [
    {}
  ],
  "confirmDeleteAllSteps": true,
  "senderProfileIds": [
    "<string>"
  ],
  "senderProfileId": "<string>",
  "linkedinIntegrationIds": [
    "<string>"
  ],
  "phoneIntegrationIds": [
    "<string>"
  ],
  "phoneNumbers": [
    "<string>"
  ],
  "voiceId": "<string>",
  "crmSyncEnabled": true,
  "crmIntegrationId": "<string>",
  "notificationUserIds": [
    "<string>"
  ]
}
'

import requests

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

payload = {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "includeUnsubscribeText": True,
    "unsubscribeText": "<string>",
    "partial": True,
    "steps": [{}],
    "confirmDeleteAllSteps": True,
    "senderProfileIds": ["<string>"],
    "senderProfileId": "<string>",
    "linkedinIntegrationIds": ["<string>"],
    "phoneIntegrationIds": ["<string>"],
    "phoneNumbers": ["<string>"],
    "voiceId": "<string>",
    "crmSyncEnabled": True,
    "crmIntegrationId": "<string>",
    "notificationUserIds": ["<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({
    id: '<string>',
    name: '<string>',
    description: '<string>',
    includeUnsubscribeText: true,
    unsubscribeText: '<string>',
    partial: true,
    steps: [{}],
    confirmDeleteAllSteps: true,
    senderProfileIds: ['<string>'],
    senderProfileId: '<string>',
    linkedinIntegrationIds: ['<string>'],
    phoneIntegrationIds: ['<string>'],
    phoneNumbers: ['<string>'],
    voiceId: '<string>',
    crmSyncEnabled: true,
    crmIntegrationId: '<string>',
    notificationUserIds: ['<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([
    'id' => '<string>',
    'name' => '<string>',
    'description' => '<string>',
    'includeUnsubscribeText' => true,
    'unsubscribeText' => '<string>',
    'partial' => true,
    'steps' => [
        [
                
        ]
    ],
    'confirmDeleteAllSteps' => true,
    'senderProfileIds' => [
        '<string>'
    ],
    'senderProfileId' => '<string>',
    'linkedinIntegrationIds' => [
        '<string>'
    ],
    'phoneIntegrationIds' => [
        '<string>'
    ],
    'phoneNumbers' => [
        '<string>'
    ],
    'voiceId' => '<string>',
    'crmSyncEnabled' => true,
    'crmIntegrationId' => '<string>',
    'notificationUserIds' => [
        '<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  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"unsubscribeText\": \"<string>\",\n  \"partial\": true,\n  \"steps\": [\n    {}\n  ],\n  \"confirmDeleteAllSteps\": true,\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"voiceId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ]\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  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"unsubscribeText\": \"<string>\",\n  \"partial\": true,\n  \"steps\": [\n    {}\n  ],\n  \"confirmDeleteAllSteps\": true,\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"voiceId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ]\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  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"unsubscribeText\": \"<string>\",\n  \"partial\": true,\n  \"steps\": [\n    {}\n  ],\n  \"confirmDeleteAllSteps\": true,\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"voiceId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ]\n}"

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

{
  "sequence": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "status": "<string>",
    "memberCount": 123,
    "created": "<string>",
    "updated": "<string>",
    "includeUnsubscribeText": true,
    "unsubscribeText": "<string>",
    "steps": [
      {
        "id": "<string>",
        "sequenceId": "<string>",
        "senderProfile": "<string>",
        "order": 123,
        "daysAfterPrevious": 123,
        "actionType": "<string>",
        "platform": "<string>",
        "stepName": "<string>",
        "subject": "<string>",
        "content": "<string>",
        "actionParameters": {},
        "autoAgentParameters": {
          "goal": "<string>",
          "agentId": "<string>",
          "useSenderProfileAgent": true,
          "abilities": [
            "<string>"
          ],
          "autoAgentChannel": "<string>",
          "maxSteps": 123,
          "minResponseDelayMinutes": 123,
          "maxResponseDelayMinutes": 123
        },
        "aiPersonalized": true,
        "aiPersonalizedInstructions": "<string>",
        "trackCalendarBooking": true,
        "schedulingIntegrationId": "<string>",
        "abTestEnabled": true,
        "abTestName": "<string>",
        "variants": [
          {}
        ],
        "created_date": "<string>",
        "updated_date": "<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 '
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "includeUnsubscribeText": true,
  "unsubscribeText": "<string>",
  "partial": true,
  "steps": [
    {}
  ],
  "confirmDeleteAllSteps": true,
  "senderProfileIds": [
    "<string>"
  ],
  "senderProfileId": "<string>",
  "linkedinIntegrationIds": [
    "<string>"
  ],
  "phoneIntegrationIds": [
    "<string>"
  ],
  "phoneNumbers": [
    "<string>"
  ],
  "voiceId": "<string>",
  "crmSyncEnabled": true,
  "crmIntegrationId": "<string>",
  "notificationUserIds": [
    "<string>"
  ]
}
'

import requests

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

payload = {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "includeUnsubscribeText": True,
    "unsubscribeText": "<string>",
    "partial": True,
    "steps": [{}],
    "confirmDeleteAllSteps": True,
    "senderProfileIds": ["<string>"],
    "senderProfileId": "<string>",
    "linkedinIntegrationIds": ["<string>"],
    "phoneIntegrationIds": ["<string>"],
    "phoneNumbers": ["<string>"],
    "voiceId": "<string>",
    "crmSyncEnabled": True,
    "crmIntegrationId": "<string>",
    "notificationUserIds": ["<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({
    id: '<string>',
    name: '<string>',
    description: '<string>',
    includeUnsubscribeText: true,
    unsubscribeText: '<string>',
    partial: true,
    steps: [{}],
    confirmDeleteAllSteps: true,
    senderProfileIds: ['<string>'],
    senderProfileId: '<string>',
    linkedinIntegrationIds: ['<string>'],
    phoneIntegrationIds: ['<string>'],
    phoneNumbers: ['<string>'],
    voiceId: '<string>',
    crmSyncEnabled: true,
    crmIntegrationId: '<string>',
    notificationUserIds: ['<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([
    'id' => '<string>',
    'name' => '<string>',
    'description' => '<string>',
    'includeUnsubscribeText' => true,
    'unsubscribeText' => '<string>',
    'partial' => true,
    'steps' => [
        [
                
        ]
    ],
    'confirmDeleteAllSteps' => true,
    'senderProfileIds' => [
        '<string>'
    ],
    'senderProfileId' => '<string>',
    'linkedinIntegrationIds' => [
        '<string>'
    ],
    'phoneIntegrationIds' => [
        '<string>'
    ],
    'phoneNumbers' => [
        '<string>'
    ],
    'voiceId' => '<string>',
    'crmSyncEnabled' => true,
    'crmIntegrationId' => '<string>',
    'notificationUserIds' => [
        '<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  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"unsubscribeText\": \"<string>\",\n  \"partial\": true,\n  \"steps\": [\n    {}\n  ],\n  \"confirmDeleteAllSteps\": true,\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"voiceId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ]\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  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"unsubscribeText\": \"<string>\",\n  \"partial\": true,\n  \"steps\": [\n    {}\n  ],\n  \"confirmDeleteAllSteps\": true,\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"voiceId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ]\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  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"includeUnsubscribeText\": true,\n  \"unsubscribeText\": \"<string>\",\n  \"partial\": true,\n  \"steps\": [\n    {}\n  ],\n  \"confirmDeleteAllSteps\": true,\n  \"senderProfileIds\": [\n    \"<string>\"\n  ],\n  \"senderProfileId\": \"<string>\",\n  \"linkedinIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneIntegrationIds\": [\n    \"<string>\"\n  ],\n  \"phoneNumbers\": [\n    \"<string>\"\n  ],\n  \"voiceId\": \"<string>\",\n  \"crmSyncEnabled\": true,\n  \"crmIntegrationId\": \"<string>\",\n  \"notificationUserIds\": [\n    \"<string>\"\n  ]\n}"

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

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

string

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

name

string

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

description

string

Sequence description

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.

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.

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).

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.

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.

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.

senderProfileId

string

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

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.

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.

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.

crmSyncEnabled

boolean

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

crmIntegrationId

string

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

notificationUserIds

string[]

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

Response

Created sequence

Sequence response

sequence

object

Sequence object

Show child attributes

⌘I

Integrations

Documents

Keys

Employees

Chat

Projects

Memories

Companies

Company Users

Usage

Organizations

Models

Mcp

Browser

Images

Audio

Video

Agents

Lists

Sequences

People

Inbox

Content

Voices

Leads

Web

Canvas

Support

Tags

Departments

Documentation

Landing Pages

Monitors

Content Research

SEO

Marketing Campaigns

Create or update a sequence.

Authorizations

Body

Response