For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.
Path parameters
campaignIdstringRequiredformat: "uuid"
Campaign ID
Request
This endpoint expects an object.
allowedDayslist of integers or nullOptional
DEPRECATED: Use call_windows instead. Allowed days of week (1=Monday through 7=Sunday)
callWindowslist of objects or nullOptional
Call time windows in UTC, replaces all existing windows (empty array clears all)
concurrentCallsinteger or nullOptional
Maximum number of simultaneous calls (1-50)
descriptionstring or nullOptional
Optional description of the campaign purpose
earliestCallTimestring or nullOptional
DEPRECATED: Use call_windows instead. Earliest time to call (HH:MM)
endAtdatetime or nullOptional
End time after which the campaign auto-pauses, must be after start_at
latestCallTimestring or nullOptional
DEPRECATED: Use call_windows instead. Latest time to call (HH:MM)
namestring or nullOptional
Human-readable name for the campaign
respectContactTimezoneboolean or nullOptional
Whether to check each contact's timezone before calling
startAtdatetime or nullOptional
Scheduled start time, must be in the future if provided
Response
Campaign updated
allowedDayslist of integers
DEPRECATED: Use call_windows instead. Allowed days of week
callWindowslist of objects
Call time windows in UTC
concurrentCallsinteger
Maximum number of simultaneous calls
createdAtdatetime
When the campaign was created
earliestCallTimestring
DEPRECATED: Use call_windows instead. Earliest call time in HH:MM
flowIdstringformat: "uuid"
Flow (conversation script) used for all calls
fromPhoneNumberstring
Caller ID phone number in E.164 format
idstringformat: "uuid"
Unique identifier for the campaign
latestCallTimestring
DEPRECATED: Use call_windows instead. Latest call time in HH:MM
namestring
Human-readable name for the campaign
progressobject
Contact processing progress counters
providerIdstringformat: "uuid"
VoIP provider used for routing
respectContactTimezoneboolean
Whether each contact's timezone is checked before calling
sourcestring
Driving subsystem: user (standard campaign) or meta_lead (auto-created
envelope grouping Meta Lead Ads calls; fed on lead arrival, not by the scheduler)
statusenum
Current status of the campaign
completedAtdatetime or nullOptional
When the campaign finished processing all contacts
descriptionstring or nullOptional
Description of the campaign purpose
endAtdatetime or nullOptional
End time after which the campaign auto-pauses
flowNamestring or nullOptional
Display name of the flow. Null when the flow has since been deleted —
the campaign still renders, it just has no name to show.
