Bulk Add Leads to 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" } ] '

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 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"

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