Create Campaign
Campaigns
Create Campaign
Create a new campaign.
Supports all-in-one creation: pass contact_ids to add contacts and
auto_start / scheduled_start_at to start the campaign in a single
request.
POST
Create Campaign
Authorizations
Workspace API key (e.g. kej_live_...)
Body
application/json
Create a campaign (public API).
Required string length:
1 - 255Persona to use
Voice agent (infers persona)
Call settings
Example:
{
"allowed_days": [0, 1, 2, 3, 4],
"auto_retry": true,
"call_end_hour": 17,
"call_start_hour": 9,
"phone_assignment_mode": "local",
"retry_schedule": [60, 240],
"scoring_criteria": "Score 0-100 based on buying intent",
"structured_data_schema": [
{
"description": "Stated budget range",
"key": "budget"
},
{
"description": "Decision timeline",
"key": "timeline"
}
],
"tags": [
{
"description": "Contact expressed buying interest",
"name": "Interested"
},
{
"description": "Contact requested a follow-up call",
"name": "Follow-up"
}
]
}Contact IDs to add (max 10,000)
Maximum array length:
10000Queue priority
Required range:
1 <= x <= 100Naive datetime 'YYYY-MM-DDTHH:MM' per contact timezone
Start immediately after adding contacts

