Add numbers from a contact list

POST/v1/accounts/{accountId}/campaigns/{campaignId}/numbers/copyFromContactList

Copies all the numbers of a contact list, with their variable values, to a campaign.

If the campaign has no numbers yet, it takes the variable names of the contact list. Otherwise, both must have the same variable names, or the request fails with 409 Conflict.

Numbers can be added to campaigns in Draft state, and to Active or Paused campaigns with Dynamic number provisioning. Other campaigns return 409 Conflict.

Duplicates are handled differently depending on the state of the campaign. In Draft campaigns, a number with the same variable values as an existing one is skipped (the same number can be added again with different values). In Active or Paused campaigns, every number sent is added, even if it already exists, since it's considered a new call to make, for example to contact the same customer again.

Path parameters

accountIduuidRequired

ID of your SIP Caller account. See Account ID.

campaignIduuidRequired

ID of the campaign.

Request body

contactListIduuidRequired

ID of the contact list whose numbers are copied.

Returns

Returns an object with the result of the operation:

totalNumbersinteger

Number of numbers in the contact list.

numbersAddedinteger

Number of numbers added to the campaign.

numbersSkippedinteger

Number of numbers not added because they were duplicated.

POST

/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers/copyFromContactList

curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers/copyFromContactList' \ -H 'Authorization: Bearer API_KEY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "contactListId": "CONTACT_LIST_ID" }'

Response

200 OK

{ "totalNumbers": 2000, "numbersAdded": 2000, "numbersSkipped": 0 }


SIP Caller
© 2026 Easy Caller LLC All Rights Reserved
LinkedinYou Tube
Trustpilot