Creates a new Contact Batch

Contact Batch is a list of contacts associated with a broadcast. You can use this operation to attach a list of contacts to an existing Campaign. A list of ToNumbers or an existing Contact List id is required to create and attach the Contact List. The unique contactListId is returned, which can be used in ControlContactBatch to enable or disable this batch.


Parameter Data Type Demo Value Description
CreateContactBatch object Create ContactBatch using attached info
RequestId anyURI
BroadcastId long Id of Broadcast
Name string
To * List[PhoneNumber] 13105551234,1310555145 List of E.164 11 digit numbers space or comma separated
ContactListId * long
ScrubBroadcastDuplicates boolean


Parameter Data Type Description
CreatedId long Unique ID of resource


using RestSharp;

namespace [your-namespace]
    public class [your-class]
        public string CreateContactBatch()
            long broadcastId = 18; //Your Broadcast Id here

            var client = new RestClient("");
            client.Authenticator = new HttpBasicAuthenticator("YourLoginId", "password");

            var request = new RestRequest(string.Format("broadcast/{0}/batch", broadcastId), Method.POST);
            request.AddParameter("Name", "My Test API ContactBatch Numbers List");
            request.AddParameter("To", "13105551216, 13105551217");
            request.AddParameter("ContactListId", "2");
            request.AddParameter("ScrubBroadcastDuplicates", "true");

            var response = client.Execute(request);
            string content = response.Content;
            return content;

The XML returned is:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<r:ResourceReference xmlns="" xmlns:r="">