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

# Create sequence

`POST /workspaces/{workspaceID}/sequences`

## Request

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

Create a new sequence.

## Path parameters

- `workspaceID` string, required

## Request body

- ApiCreateSequenceRequest
  - `language` 'russian' | 'ukrainian' | 'finnish' | 'american_english' | 'british_english' | 'french' | 'spanish' | 'polish' | 'romanian' | 'german' | 'lithuanian' | 'dutch' | 'latvian' | 'italian' | 'czech' | 'hungarian' | 'japanese' | 'brazilian_portugese' | 'swedish' | 'danish' | 'norwegian' | 'estonian', required
  - `name` string, required
  - `productId` string, required
  - `timezone` string, required

## Response `201`

Created sequence

- ApiSequenceResponse
  - `agentId` string
  - `bouncedCount` integer
  - `bouncedPercent` number
  - `clickTrackingEnabled` boolean
  - `clickedCount` integer
  - `clickedPercent` number
  - `companyOutreachLimitCount` integer
  - `companyOutreachLimitEnabled` boolean
  - `completedCount` integer
  - `completedPercent` number
  - `contactedCount` integer
  - `id` string
  - `leadCount` integer
  - `localizedOptOutEnabled` boolean
  - `mailboxes` ApiSequenceMailboxResponse[]
    - `address` string
    - `firstName` string
    - `id` string
    - `lastName` string
  - `name` string
  - `openTrackingEnabled` boolean
  - `openedCount` integer
  - `openedPercent` number
  - `optOutedCount` integer
  - `optOutedPercent` number
  - `productId` string
  - `repliedCount` integer
  - `repliedPercent` number
  - `repliedPositiveCount` integer
  - `repliedPositivePercent` number
  - `sequentialCompanySendingEnabled` boolean
  - `status` 'active' | 'draft' | 'paused' | 'deleted' | 'completed' | 'video_pending' | 'active' | 'paused'
  - `steps` ApiSequenceStepResponse[]
    - `distributionStrategy` 'equal' | 'custom' | 'equal' | 'custom'
    - `id` string
    - `name` string
    - `order` integer
    - `variants` ApiSequenceStepVariantResponse[]
      - `contactInformationSource` 'linkedin' | 'website' | 'all' | 'linkedin' | 'website' | 'all'
      - `distributionWeight` number
      - `dynamicLanguageEnabled` boolean
      - `emailContent` string
      - `emailSubject` string
      - `id` string
      - `isGenerated` boolean
      - `label` string
      - `order` integer
      - `overdriveEnabled` boolean
      - `status` 'active' | 'paused' | 'deleted' | 'active' | 'paused'
      - `tonality` 'playful' | 'hilarious' | 'formal' | 'curious' | 'urgent' | 'appreciative' | 'polite' | 'enthusiastic' | 'warm' | 'empathetic' | 'direct' | 'persuasive' | 'confident' | 'respectful' | 'helpful' | 'sincere' | 'encouraging' | 'informal' | 'caring' | 'diplomatic' | 'assertive' | 'reassuring' | 'authoritative'
    - `waitDays` integer
  - `workspaceId` string

## Other responses

- `500`: Internal Server Error

---

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