POST
/
v1
/
campaigns
Create a Campaign
curl --request POST \
  --url https://api.bland.ai/v1/campaigns \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "name": "<string>",
  "numbers": [
    "<string>"
  ],
  "sequence": {}
}'
{
  "status": "success",
  "campaign_id": "0a810190-c000-aaaa-bbbb-16a4630cc190"
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
name
string
required
Name for your campaign to later reference.
​
numbers
string[]
required
An array of strings containing different phone numbers.Example:
  ["+19543110000", "..."]
​
sequence
object
required
A list of strings with different phone numbers.sequence.retries - (INTEGER) Number of times to retry when no answer. sequence.wait_period - (INTEGER) Number of days to wait in between follow ups (retries).Example:
{
    ...,
    "sequence":{
        "retries": 4,
        "wait_period": 1
    }
}
​
*
All other parameters supported by the Send Call endpoint are supported here as well. They will be applied to each call in the batch.

​
Response

​
status
string
Confirms the request was successful, or provides an error message if the request failed.
​
campaign_id
string
The unique identifier for the campaign.
{
  "status": "success",
  "campaign_id": "0a810190-c000-aaaa-bbbb-16a4630cc190"
}