Skip to main content
POST
/
api
/
v2
/
voice-campaigns
/
{campaign_id}
/
leads
/
bulk
Bulk Add Leads to Voice Campaign
curl --request POST \
  --url https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaign_id}/leads/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "phone_number": "+14155552671",
    "first_name": "Jane",
    "last_name": "Doe"
  },
  {
    "phone_number": "+14155559999",
    "first_name": "John",
    "last_name": "Smith"
  }
]
'
{
  "status": "success",
  "message": "Leads are queued to be added to the campaign"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
campaign_id
string
required

Identifier of the voice campaign. Required.

Example:

"camp_abc123"

Body

application/json

Array of lead objects to add

​
phone_number
string
required

Lead phone number in E.164 format. Required.

Example:

"+14155552671"

​
first_name
string

Lead first name. Optional.

Example:

"Jane"

​
last_name
string

Lead last name. Optional.

Example:

"Doe"

​
email
string<email>

Lead email address. Optional.

Example:

"jane.doe@example.com"

​
custom_fields
object

Additional key-value pairs for call script personalisation. Optional.

Example:
{
  "company": "Acme Corp",
  "plan": "enterprise"
}
Example:
[
  {
    "phone_number": "+14155552671",
    "first_name": "Jane",
    "last_name": "Doe"
  },
  {
    "phone_number": "+14155559999",
    "first_name": "John",
    "last_name": "Smith"
  }
]

Response

Leads queued successfully. Processing happens asynchronously — check campaign lead counts to confirm completion.

​
status
string
Example:

"success"

​
message
string