---
title: "Create sequence"
method: POST
path: "/multichannel/workspaces/{workspaceID}/sequences"
tags: ["Sequences"]
---

# Create sequence

`POST /multichannel/workspaces/{workspaceID}/sequences`

## Request

- Base URL: `https://multichannel-api.salesforge.ai/public`
- URL: `https://multichannel-api.salesforge.ai/public/multichannel/workspaces/{workspaceID}/sequences`
- Auth: API key in header `Authorization`

builderMode defaults to legacy, which is deprecated; new integrations should send converging. A converging sequence starts as root to terminal and rejoins split paths at terminal nodes; the mode cannot be changed afterwards.

## Path parameters

- `workspaceID` string, required

## Request body

- union
  - object
  - RequestsCreateSequenceRequest
    - `builderMode` 'legacy' | 'converging'
    - `description` string
    - `kind` 'primary' | 'subsequence'
    - `name` string, required
    - `settings` RequestsSequenceSettingsInput
      - `bcc` string
      - `bounceShieldEnabled` boolean
      - `cc` string
      - `ccAndBccEnabled` boolean
      - `clickTrackingEnabled` boolean
      - `companyOutreachLimitCount` integer
      - `companyOutreachLimitEnabled` boolean
      - `espMatchingEnabled` boolean
      - `localizedOptOutEnabled` boolean
      - `openTrackingEnabled` boolean
      - `opportunitiesValue` number
      - `optOutLinkEnabled` boolean
      - `optOutLinkText` string
      - `optOutText` string
      - `optOutTextEnabled` boolean
      - `pauseOnClick` boolean
      - `pauseOnOpen` boolean
      - `plainTextEmailsEnabled` boolean
      - `sendingPriority` 'regular' | 'high'
      - `sequentialCompanySendingEnabled` boolean
      - `taskPriorityPolicy` 'new_contacts' | 'followups_first'
      - `trackOpportunitiesEnabled` boolean
    - `timezone` string, required

## Response `201`

Created

- ResponsesCreateSequenceResponse
  - `builderMode` string
  - `description` string
  - `id` integer
  - `kind` string
  - `name` string
  - `settings` ResponsesSequenceSettingsResponse
    - `bcc` string
    - `bounceShieldEnabled` boolean
    - `cc` string
    - `ccAndBccEnabled` boolean
    - `clickTrackingEnabled` boolean
    - `companyOutreachLimitCount` integer
    - `companyOutreachLimitEnabled` boolean
    - `espMatchingEnabled` boolean
    - `localizedOptOutEnabled` boolean
    - `openTrackingEnabled` boolean
    - `opportunitiesValue` number
    - `optOutLinkEnabled` boolean
    - `optOutLinkText` string
    - `optOutText` string
    - `optOutTextEnabled` boolean
    - `pauseOnClick` boolean
    - `pauseOnOpen` boolean
    - `plainTextEmailsEnabled` boolean
    - `sendingPriority` 'regular' | 'high'
    - `sequentialCompanySendingEnabled` boolean
    - `taskPriorityPolicy` 'new_contacts' | 'followups_first'
    - `trackOpportunitiesEnabled` boolean
  - `status` string
  - `timezone` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/salesforge/apis/multichannel-public-api.md) - [All operations](https://skmtc.dev/salesforge/apis/multichannel-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/salesforge/apis/multichannel-public-api/revisions/f4dc28ed447d?raw)