Skip to main content
POST
Create a new program

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Program name

flowId
string
required

Flow ID to execute

startAt
string
required

Scheduled start time (ISO 8601)

Example:

"2025-12-20T09:00:00Z"

didPool
string[]
required

Pool of DID UUIDs to use for outbound calls (at least one)

Example:
retryStrategy
object
required

Retry strategy for failed calls

mode
enum<string>
default:batch

Program mode: batch (static audience) or live (trigger-based)

Available options:
batch,
live
audienceId
string

Audience ID to call (required for batch mode)

triggerCondition
object

Trigger condition (required for live mode)

stopAt
string

Scheduled stop time (ISO 8601)

Example:

"2025-12-20T18:00:00Z"

pauseWindows
object
autoPauseRules
object[]

Auto-pause rules: pause execution when counters reach thresholds

Response

Program created

id
string
required

Program ID

name
string
required

Program name

mode
enum<string>
required

Program mode

Available options:
batch,
live
organizationId
string
required

Organization ID

audienceId
string
required

Audience ID. Set at creation for batch, auto-created for live.

flowId
string
required

Flow ID

status
enum<string>
required

Program lifecycle status. Operational status is on executions.

Available options:
draft,
active,
archived
startAt
string
required

Scheduled start time

didPool
object[]
required

Resolved DID pool

retryStrategy
object | null
required

Retry strategy

createdAt
string
required

Created at

updatedAt
string
required

Updated at

triggerCondition
object

Trigger condition (live mode only)

stopAt
string | null

Scheduled stop time

pauseWindows
object | null

Pause windows

autoPauseRules
object | null

Auto-pause rules