curl --request POST \
--url 'https://api.vida.dev/api/v2/agent/outboundCall?token=' \
--header 'Content-Type: application/json' \
--data '
{
"target": "+15551234567",
"context": "Call back about pricing",
"meta": {
"contact": {
"name": "Example Person",
"email": "lead@example.com",
"address": {
"state": "LA",
"zip": "71101"
},
"customFields": {
"vendorLeadCode": "lead-123"
}
}
}
}
'{
"success": true,
"message": "Outbound call initiated.",
"inserted": 3,
"batchId": "f52b1e01-5cbc-483c-9939-3bf7d37e1426",
"tasks": [
{}
]
}Queue outbound call(s) from your Agent
Queue call Tasks for one target or up to 10,000 targets. The endpoint accepts Task goals, retry policies, organization defaults, external correlation IDs, metadata, and Contact List enrollment. Submissions over 1,000 targets require Idempotency-Key and return 202. Use meta.contact for structured Contact data such as name, email, address and customFields. In a batch, put lead-specific metadata on each target object. See Contact fields for the complete metadata field reference.
curl --request POST \
--url 'https://api.vida.dev/api/v2/agent/outboundCall?token=' \
--header 'Content-Type: application/json' \
--data '
{
"target": "+15551234567",
"context": "Call back about pricing",
"meta": {
"contact": {
"name": "Example Person",
"email": "lead@example.com",
"address": {
"state": "LA",
"zip": "71101"
},
"customFields": {
"vendorLeadCode": "lead-123"
}
}
}
}
'{
"success": true,
"message": "Outbound call initiated.",
"inserted": 3,
"batchId": "f52b1e01-5cbc-483c-9939-3bf7d37e1426",
"tasks": [
{}
]
}Authorizations
Vida API Token
Headers
Required for submissions over 1,000 targets. Repeating the same key and payload safely resumes or returns that submission.
Show child attributes
Show child attributes
Body
- Option 1
- Option 2
Phone in E.164 or VIDA username
"+1234567890"
Context for the agent to use during the call
"Name: Lyle Pratt. Interested in product demo."
Task-specific context injected only for this call
Custom greeting to use at call start
Delay greeting until caller speaks
Optional agent account id override for the call
Unix seconds in the future to schedule the call
Task-specific goal with completionCriteria. Omit or pass null to use the organization default.
Task-specific cadence using delaysSeconds or mixed-channel steps, retryOn, and optional responseTimeoutSeconds. Omit or pass null to use the organization default.
Optional Task metadata. meta.contact fills missing structured Contact fields at creation; existing values are preserved. For multiple targets, set contact data in meta.contact on each target object. Per-item meta replaces the entire top-level meta object; it is not deep-merged. To call target first and bridge them elsewhere, use meta.bridgeAfterAnswer.
Show child attributes
Show child attributes
Reusable customer correlation/grouping ID; not an idempotency key
Optional Contact List to enroll the contact into