Skip to main content
POST
Create campaign

Authorizations

x-api-key
string
header
required

Create and manage API keys in your AgentCallback account under Dashboard > API Keys.

Body

application/json

Campaign configuration.

name
string
required
script_id
string
required
description
string
file_upload_id
string<uuid>

ID returned by POST /api/file-uploads.

variable_mappings
object
from_phone_number
string
routing_strategy
enum<string>
Available options:
single,
geographic,
random
campaign_timezone
string
Example:

"America/Los_Angeles"

scheduled_date
string<date>

Provide with scheduled_time to create a scheduled campaign; omit both to create a draft.

scheduled_time
string

Provide with scheduled_date to create a scheduled campaign; omit both to create a draft.

Example:

"09:00"

scheduled_timezone_input
string
Example:

"America/Los_Angeles"

working_hours
object | null
working_hours_timezone
string

Optional IANA override; otherwise uses campaign_timezone.

Example:

"America/New_York"

workflow_config
object | null

Optional multi-attempt workflow. When configured, it supersedes simple retry settings.

Example:
max_concurrent_calls
integer
Required range: 1 <= x <= 6
call_spacing_seconds
integer
Required range: x >= 0
api_contacts_enabled
boolean

For outbound campaigns without a CSV. Start the campaign, then submit contacts through POST /api/make-calls with campaign_id.

Response

Campaign created

success
boolean
required
Example:

true

campaign
object