Skip to main content
POST
Create a campaign
Required scope: campaigns.edit

Authorizations

Authorization
string
header
required

Your API key, e.g. pk_live_xxxxxxxxxxxxxxxxxxxxxxxx.

Body

application/json
source
enum<string>
required
Available options:
INBOUND
phoneNumberId
string<uuid>
required
name
string
default:""
Maximum string length: 100
description
string
Maximum string length: 280
reservedConcurrency
integer
Required range: 1 <= x <= 10
variableMap
object
countryCode
string
Pattern: ^\+\d{1,3}$
phoneColumn
string
altPhoneColumns
string[]
Maximum array length: 5
Minimum string length: 1
nameColumn
string
firstNameColumn
string
lastNameColumn
string
removeInvalidRows
boolean
transliterateCalleeNames
boolean
timezone
string
scheduledStartAt
string<date-time>
scheduledEndAt
string<date-time>
dailyWindowStart
string
Pattern: ^\d{2}:\d{2}$
dailyWindowEnd
string
Pattern: ^\d{2}:\d{2}$
retryCount
integer
Required range: 0 <= x <= 10
cooldownMinutes
integer
Required range: 5 <= x <= 43200
retryDelaysMinutes
integer[]
Maximum array length: 10
Required range: 1 <= x <= 43200
retryConcurrencyPercent
integer | null
Required range: 0 <= x <= 100
notificationUserIds
string[]
campaignTypeId
string
customExtractionKeys
object[]
Maximum array length: 40
defaultCrmConnectionId
string
defaultCrmSegmentId
string
followupEnabled
boolean
followupMaxAttempts
integer
Required range: 1 <= x <= 10
churnEnabled
boolean
churnMaxAttempts
integer
Required range: 1 <= x <= 10
churnIntervalHours
integer
Required range: 1 <= x <= 2160
churnDelaysHours
integer[]
Maximum array length: 10
Required range: 1 <= x <= 2160
goal
string | null
Maximum string length: 500
briefText
string | null
Maximum string length: 200000
briefFileName
string | null
Maximum string length: 255
incompleteRetryEnabled
boolean
incompleteRetryMaxAttempts
integer
Required range: 1 <= x <= 5
incompleteRetryIntervalMinutes
integer
Required range: 1 <= x <= 1440
incompleteRetryDelaysMinutes
integer[]
Maximum array length: 5
Required range: 1 <= x <= 1440
incompleteCallSeconds
integer
Required range: 5 <= x <= 300
referralMaxDepth
integer
Required range: 0 <= x <= 3
skipRetryOnFirstVoicemail
boolean
messageRetryEnabled
boolean
messageRetryMaxAttempts
integer
Required range: 1 <= x <= 10
messageRetryIntervalSeconds
integer
Required range: 1 <= x <= 604800
messageRetryDelaysSeconds
integer[]
Maximum array length: 10
Required range: 1 <= x <= 604800
messageRetryWindowSeconds
integer
Required range: 1 <= x <= 2592000
messageRetryTieredEnabled
boolean
messageRetryTransientMaxAttempts
integer
Required range: 1 <= x <= 100
autoReseedEnabled
boolean
channel
enum<string>
Available options:
VOICE,
WHATSAPP,
VOICE_THEN_WHATSAPP,
WHATSAPP_THEN_VOICE,
CUSTOM,
EMAIL
whatsappOutreachTemplateId
string | null
whatsappTemplateByMetric
object
messageDeclinedLeads
boolean
outreachRules
object[] | null
Maximum array length: 20
dailyDialCap
integer | null
Required range: 1 <= x <= 100000
dailyMessageCap
integer | null
Required range: 1 <= x <= 100000
dialDays
integer[]
Required array length: 1 - 7 elements
Required range: 0 <= x <= 6
evaluationMetrics
object[]
Maximum array length: 12
applyAgentDefaults
boolean
agentId
string
Minimum string length: 1
activate
boolean

Response

Created

campaignId
string
required
contactsAdded
number
required
contactsSkipped
number
required
skippedReasons
string[]
required