Skip to main content
POST
Create a task batch

Authorizations

token
string
query
required

Vida API Token

Headers

Idempotency-Key
string

Required for submissions over 1,000 Tasks. Repeating the same key and payload safely resumes or returns that submission; reusing it for a different payload returns 409.

Maximum string length: 200

Body

application/json
tasks
object[]

Explicit Task objects. Each requires type; call, text, and email also require target.

Required array length: 1 - 10000 elements
contactListName
string

Create one Task for every eligible Contact List member

task
object

Task template without target for the selected Contact List. Supports call, text, and email and the same goal/retryPolicy fields as POST /api/v2/tasks.

Response

Task batch created