Massive Voice Campaign

Go4clients bases its functionality on campaigns. A campaign is a set of events (Calls, SMS, Landing pages, and many more) with the same characteristics that allows your organization to categorize your customers according to your needs and contact them evenly. Each petition to this API will create a new campaign for your organization. You can find the interactions that your customers have with it in the “Robocall analytics” section.

The voice API helps you to create massive campaigns no matter what programming language your organization uses since Go4clients APIs use standard REST services that are easily integrated with any application.

1. HTTP Methods

To send a massive voice campaign you need to call a POST HTTP . The following URLs are used to publish the outbound calls service:

HTTPS (Recommended)

HTTP (non-SSL)

The following HTTP request will create a new campaign and send the call structure inside “callSteps” to all the numbers inside the “toList” using the caller id: “from“.

2. Authentication

All requests require API Key and API Secret authentication credentials. Your Account Administrator can this information under “My Profile > Settings > API” section.

The security information goes in the POST Headers:

String (Required)

The account’s Api key username (key), a 32 character random generated string.

String (Required)

The account’s API password (secret). It’s a numeric random string with a random length between 10 and 15 characters.

 Please be advised that the header also have to include a parameter “Content-Type” with value “application/json”.

3. Request Parameters

Request Parameters
String (Required)

Caller Id that the your customers will see when picking up the call. The Caller ID number can be any number entered by the user that calls the service, and must have a max length of 15 numeric characters. e.g.: 123456789012345. However it’s recommended to use a valid mobile number.

String (1…*) (Required)

The list of recipients for this massive campaign. Each destination number must be in international format (country code) + (mobile number) and can only contain digits Example: 573004445566 when sending to the Colombia.

String (1…*) (Required)

It has the call structure that the recipients will interact with. Please see the  Annex D: Step types and how to use them

PHP example

Java example (with Apache HTTPClient)

4. Response Parameters

For information about the error codes of the voice api, please see the Annex B: Voice Api Error Table

Response Parameters

Code that identifies the error in the Voice Api Error Table


Brief description of the error.


It indicates if the service response is successful or not


Unique identificator for the created voice campaign