Skip to main content
POST

Authorizations

token
string
query
required

Vida API Token

Headers

Idempotency-Key
string

Required for submissions over 1,000 targets. Repeating the same key and payload safely resumes or returns that submission.

Maximum string length: 200

Body

application/json
target
string
required

Phone in E.164 or VIDA username

Example:

"+1234567890"

context
string

Context for the agent to use during the call

Example:

"Name: Lyle Pratt. Interested in product demo."

taskContext
string

Task-specific context injected only for this call

greeting
string

Custom greeting to use at call start

waitToGreet
boolean

Delay greeting until caller speaks

accountId
integer

Optional agent account id override for the call

scheduledFor
integer

Unix seconds in the future to schedule the call

goal
object | null

Task-specific goal with completionCriteria. Omit or pass null to use the organization default.

retryPolicy
object | null

Task-specific cadence using delaysSeconds or mixed-channel steps, retryOn, and optional responseTimeoutSeconds. Omit or pass null to use the organization default.

meta
object

Optional metadata. To call target first and then bridge them to another destination, pass bridgeAfterAnswer with destination and optional monitor.

externalTaskId
string

Reusable customer correlation/grouping ID; not an idempotency key

contactListName
string

Optional Contact List to enroll the contact into

Response

Queued successfully

success
boolean
Example:

true

message
string
Example:

"Outbound call initiated."

inserted
integer
Example:

3

batchId
string
Example:

"f52b1e01-5cbc-483c-9939-3bf7d37e1426"

tasks
object[]