Skip to main content
POST
/
api
/
agents
/
{agentId}
/
calls
/
campaign
Create a new campaign call
curl --request POST \
  --url https://api.getstrada.com/api/agents/{agentId}/calls/campaign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaignName": "<string>",
  "scheduleId": "<string>",
  "phoneNumber": "<string>",
  "phoneNumberId": "<string>",
  "variables": {},
  "callRetryConfigId": "<string>",
  "localPresenceEnabled": false,
  "maxConcurrentCalls": 2,
  "endCampaignAt": 1735689600000
}
'
{
  "message": "Campaign call queued successfully"
}

Authorizations

​
Authorization
string
header
required

API Key authentication

Path Parameters

​
agentId
string
required

ID of the agent to use for the campaign

Body

application/json
​
campaignName
string
required

Name of the campaign

Maximum string length: 40
​
scheduleId
string
required

ID of the schedule to use for the campaign

​
phoneNumber
string
required

Phone number in E.164 format (e.g. +19876543210)

​
phoneNumberId
string
required

ID of the phone number to use

​
variables
object
required

Key-value pairs of variables required by the agent

​
callRetryConfigId
string

Optional ID of the retry configuration to use for failed calls

​
localPresenceEnabled
boolean
default:false

Enable local presence to match customer area codes. Requires organization to have local presence phone numbers configured.

​
maxConcurrentCalls
integer

Maximum number of concurrent calls for this campaign. Cannot exceed organization's maxConcurrentCalls limit.

Required range: x >= 1
​
endCampaignAt
integer

Unix timestamp in milliseconds when the campaign should end. Must be in the future.

Example:

1735689600000

Response

Campaign call created successfully

​
message
string
Example:

"Campaign call queued successfully"