v17

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-173538121.5 KB
Campaigns

Create a campaign

post/v1/campaigns

Request body

namestring required

Campaign name.

type'outbound' required

Campaign type. Only outbound campaigns are supported (dials contacts from a contact list).

bot_uidstring required

UID of the bot that handles calls for this campaign.

from_numberstring required

Phone number to dial from in E.164 format (e.g. "+12025551234").

contact_list_idinteger required

ID of the contact list to dial.

time_startstring required

Start time for the daily calling window in HH:MM format (e.g. "09:00").

time_endstring required

End time for the daily calling window in HH:MM format (e.g. "17:00").

timezonestring

IANA timezone for the calling window (e.g. "America/New_York"). Defaults to UTC if not specified.

daysstring[]

Days of week to run the campaign (e.g. ["Monday", "Wednesday", "Friday"]). If not provided, campaign runs as single-day. Valid values: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.

Response

Campaign created

idinteger

Unique identifier.

namestring

Campaign name.

type'outbound'

Campaign type (always outbound).

status'Scheduled' | 'Running' | 'Stopped' | 'Completed' | 'Failed' | 'Expired' | 'Paused'

Current campaign status.

bot_uidstring

Bot UID for API reference.

from_numberstring

Phone number used to dial from (E.164 format).

contact_list_idinteger

Associated contact list ID.

time_startstring

Daily calling window start time in HH:MM format.

time_endstring

Daily calling window end time in HH:MM format.

timezonestring

Calling window timezone (IANA format).

daysstring[]

Days of week the campaign runs on (for recurring campaigns).

schedule_type'single' | 'multi'

Schedule type: single (one-time) or multi (recurring on specific days).

current_indexinteger

Number of contacts already called.

total_contactsinteger

Total number of contacts in the campaign's contact list.

created_atstring date-time
updated_atstring date-time