Home » Introduction of Octopush SMS Gateway API » Voice SMS API » Sending Voice SMS to a list

Sending Voice SMS to a list


Encodage : UTF-8


Your “api-key” and “api-login” identifiers must be added in the headers.


This service allows you to create a Voice SMS campaign on a contact list.

This is a asynchronous process. This allows you to give dispatch orders without suffering a timeout. 4 services allow you to operate this type of sending:

  • Creation of the SMS Voice campaign on a list of contacts.
  • Getting the status of the campaign (calculating, ready to send, failed)
  • Deleting a Voice SMS campaign on list
  • Validating the sending of a Voice SMS campaign on list

Special parameters

list_namestringName of the list to be used for the campaign.
textstringMessage text (from 1 to 1224 characters non unicode).
recipientsarrayList of Contact objects array of objects:
    "phone_number": "+111222233334444",
    "first_name": "Alex",
    "last_name": "Connor",
    "param1": "Alex",
    "param2": null,
    "param3": null,
    "param4": null,
    "param5": null,
    "phone_number": "+2222333334444555",
    "param1": "John",
senderstringSender of the message (if the user allows it), 3-11 alphanumeric characters (a-zA-Z0-9).
send_atstring‘When you want to send the sms campaign. Format: DateTime ISO8601 (for ex: “2018-10-03T07:42:39-07:00”).’
purposestringCampaign purpose: (transactional/alert or marketing) : [“alert”,”wholesale”]
voice_genderstringVoice gender [‘male’, ‘female’]
voice_languagestringVoice Language [‘en-US’, ‘en-GB’, ‘el-GR’, ‘pl-PL’, ‘hu-HU’, ‘sv-SE’, ‘de-DE’, ‘es-ES’, ‘es-LA’, ‘fr-FR’, ‘it-IT’, ‘pt-BR’, ‘ru-RU’]
simulation_modeboolean(optional) If this value is “true”, your request will be simulated, and you will receive a fake result. Only some minimal validations will be executed.
request_idstring(optional) To avoid sending same request multiple times, setup an request ID. In case the duplication will be detected, a validation error will be returned.
auto_remove_blacklisted_numbersboolean(optional) By transmitting this field with “true” value, the blacklisted numbers will be automatically removed from your list of numbers. This service will add a charge of 0.01€ per request.

Curl Example

curl -X POST \ 
'https://api.octopush.com/v1/public/voice-campaign-on-list/create' \ 
-H 'Content-Type: application/json' \ 
-H 'api-login: ******@email.org' \ 
-H 'api-key: ************' \ 
-H 'cache-control: no-cache' \ 
-d '{
  "recipients": [
     "phone_number": "+442038828112",
     "first_name": "Alex"
  "text": "{first_name}, you have 1 Voice SMS",
  "sender": "12345",
  "voice_gender": "female",
  "voice_language": "en-GB"

Command to copy/paste

curl -X POST 'https://api.octopush.com/v1/public/voice-campaign-on-list/create' -H 'Content-Type: application/json' -H 'api-login: ******@email.org' -H 'api-key: ************' -H 'cache-control: no-cache' -d '{"recipients": [{"phone_number": "+442038828112", "first_name": "Alex"}], "text": "{first_name}, you have 1 Voice SMS", "sender": "12345", "voice_gender": "female", "voice_language": "en-GB"}'

JSON Server Response

Success : 201 CREATED

   "ticket_number": "voice_5f44ebf9e47b7"

Failure : 400 Bad Request

   "code": 400,
   "message": "Payload validation error.",
         "code": 442,
         "message": "Voice language not supported."