Save sequence draft - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Omitted steps defaults to an empty array. When actions exist, include an explicit flowGraph even for a single action or straight-line sequence; steps-only graphless writes are rejected. The graph entry and edges route execution, while steps holds action content. Omitted enrollmentRules uses product defaults. Use Create sequence for full step and flow graph guidance. Variable and source-field catalogs: sequence variables and CRM fields. A saved draft remains unpublished until Publish sequence draft.

Path parameters

sequence_idrequired
string
Sequence identifier.

Name	Type	Description
sequence_idrequired	string	Sequence identifier.

Query parameters

actorUserId · optional
string
Optional active same-organization actor override.

Name	Type	Description
actorUserId	string	Optional active same-organization actor override.

Body parameters

namerequired
string
Sequence name.
description · optional
string
Sequence description.
exitRulesrequired
object
Exit behavior; see nested definition below.
schedulerequired
object
Sending window and timezone; see nested definition below.
steps · optional
array<object>
Action content catalog referenced by flowGraph; array order does not route execution. Defaults to []. See Create sequence for step fields and valid kinds.
sourceTableId · optional
string
Linked source table identifier.
sourceTableName · optional
string
Source table display name.
emailDelivery · optional
object
Delivery mode and optional bulk provider configuration.
aiAutomationTrusted · optional
boolean
AI automation trust setting; defaults to false.
aiDraftSettings · optional
object
AI draft language settings.
enrollmentRules · optional
object
Enrollment skip rules.
flowGraph · optional
object
Required when actions exist, including straight-line designs. Declare version=1, exactly one entryNodeIds node, and explicit action nodes and routing edges.
requiredVariables · optional
array<string>
Variables required to render this sequence.
variableMap · optional
object
Variable-to-source mapping.
senderAccountIds · optional
array<string>
Sender account IDs.
senderBindings · optional
object
Sender assignment configuration.
inboxAccess · optional
object
Bulk manager access configuration.
allowHqFallback · optional
boolean|null
When omitted/null new sequences default to true; explicit false disables company-phone fallback. For an existing sequence, omission preserves its saved setting.
defaultAppendSignature · optional
boolean
Default signature behavior for steps.
voiceStyle · optional
string
Optional voice style guidance.

Name	Type	Description
namerequired	string	Sequence name.
description	string	Sequence description.
exitRulesrequired	object	Exit behavior; see nested definition below.
schedulerequired	object	Sending window and timezone; see nested definition below.
steps	array<object>	Action content catalog referenced by flowGraph; array order does not route execution. Defaults to []. See Create sequence for step fields and valid kinds.
sourceTableId	string	Linked source table identifier.
sourceTableName	string	Source table display name.
emailDelivery	object	Delivery mode and optional bulk provider configuration.
aiAutomationTrusted	boolean	AI automation trust setting; defaults to false.
aiDraftSettings	object	AI draft language settings.
enrollmentRules	object	Enrollment skip rules.
flowGraph	object	Required when actions exist, including straight-line designs. Declare version=1, exactly one entryNodeIds node, and explicit action nodes and routing edges.
requiredVariables	array<string>	Variables required to render this sequence.
variableMap	object	Variable-to-source mapping.
senderAccountIds	array<string>	Sender account IDs.
senderBindings	object	Sender assignment configuration.
inboxAccess	object	Bulk manager access configuration.
allowHqFallback	boolean\|null	When omitted/null new sequences default to true; explicit false disables company-phone fallback. For an existing sequence, omission preserves its saved setting.
defaultAppendSignature	boolean	Default signature behavior for steps.
voiceStyle	string	Optional voice style guidance.

Definitions

SequenceExitRules

Each field controls whether the sequence exits after the named event.

Fields

stopOnBounce · optional
boolean
stopOnLinkedInReply · optional
boolean
stopOnManualOptOut · optional
boolean
stopOnReply · optional
boolean

Name	Type	Description
stopOnBounce	boolean	-
stopOnLinkedInReply	boolean	-
stopOnManualOptOut	boolean	-
stopOnReply	boolean	-

SequenceSchedule

timezone is required; daily window and workday defaults are applied by the model.

Fields

timezonerequired
string
dailyWindowStart · optional
string
dailyWindowEnd · optional
string
skipHolidays · optional
boolean
workingDays · optional
array<integer>

Name	Type	Description
timezonerequired	string	-
dailyWindowStart	string	-
dailyWindowEnd	string	-
skipHolidays	boolean	-
workingDays	array<integer>	-

Errors

Status	Meaning
400	Invalid sequence graph, including actions without flowGraph.
401	An authenticated user session is required.
404	Sequence not found.
422	The submitted sequence configuration failed model validation.

Example

bash

curl -X PUT "https://app.autotouch.ai/api/sequences/67c4a4f7b4dd8f2d4999f014/draft?actorUserId=67c1dc35b4dd8f2d4999ed01" \
  -H "Authorization: Bearer $AUTOTOUCH_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Outbound follow-up","exitRules":{"stopOnBounce":true,"stopOnLinkedInReply":true,"stopOnManualOptOut":true,"stopOnReply":true},"schedule":{"timezone":"America/New_York","dailyWindowStart":"09:00","dailyWindowEnd":"17:00","skipHolidays":false,"workingDays":[1,2,3,4,5]},"steps":[{"id":"step-email-1","kind":"EMAIL","emailSendMode":"AUTOMATED","subjectTemplate":"A quick question","bodyTemplate":"Hello {{first_name}}"}],"flowGraph":{"version":1,"entryNodeIds":["action:email-1"],"nodes":[{"id":"action:email-1","kind":"action","sourceStepId":"step-email-1","position":{"x":0,"y":0}}],"edges":[]}}'

Request body

json

{
  "name": "Outbound follow-up",
  "exitRules": {
    "stopOnBounce": true,
    "stopOnLinkedInReply": true,
    "stopOnManualOptOut": true,
    "stopOnReply": true
  },
  "schedule": {
    "timezone": "America/New_York",
    "dailyWindowStart": "09:00",
    "dailyWindowEnd": "17:00",
    "skipHolidays": false,
    "workingDays": [
      1,
      2,
      3,
      4,
      5
    ]
  },
  "steps": [
    {
      "id": "step-email-1",
      "kind": "EMAIL",
      "emailSendMode": "AUTOMATED",
      "subjectTemplate": "A quick question",
      "bodyTemplate": "Hello {{first_name}}"
    }
  ],
  "flowGraph": {
    "version": 1,
    "entryNodeIds": [
      "action:email-1"
    ],
    "nodes": [
      {
        "id": "action:email-1",
        "kind": "action",
        "sourceStepId": "step-email-1",
        "position": {
          "x": 0,
          "y": 0
        }
      }
    ],
    "edges": []
  }
}

Response example

json

{
  "success": true,
  "sequence": {
    "id": "67c4a4f7b4dd8f2d4999f014",
    "name": "Outbound follow-up",
    "status": "DRAFT"
  },
  "draft": {
    "name": "Outbound follow-up"
  }
}