Skip to content

Add Numbers

POST /api/cc/campaigns/:id/contacts

Add up to 1,000 numbers per request to a draft, paused or running campaign. Numbers the campaign already has are skipped, so sending a batch again is safe. A running campaign starts calling new numbers within seconds.

Requires a Bearer API token (from Authentication / dashboard API Tokens) and the call-center permission.

Rate limit: 60 requests per minute per account, shared by all Campaign API endpoints.

Field Type Required Description
phone_numbers string[] Yes 1–1,000 numbers. Invalid and repeated numbers are skipped and counted.
Terminal window
curl -X POST https://api.awajdigital.com/api/cc/campaigns/42/contacts \
-H "Authorization: Bearer your_api_token_here" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"phone_numbers": [
"01912345678",
"01512345678"
]
}'
{
"data": {
"added": 2,
"duplicates": 0,
"invalid": 0,
"contact_count": 199
}
}
Field Type Description
added integer Numbers new to the campaign
duplicates integer Numbers the campaign already had, or given more than once
invalid integer Entries that are not a Bangladesh mobile number
contact_count integer Numbers in the campaign now
Status Code Description
401 — Missing or invalid access token
403 — Account does not have the call-center permission
404 campaign_not_found Unknown campaign, or not on your account
409 invalid_status The campaign is stopped or completed
422 no_valid_numbers None of the numbers is valid
422 — Validation error (errors array)
429 — Rate limit exceeded (60 requests/minute)