Skip to content
Home » SMS API » Send SMS to contacts

Send SMS to contacts



Encoding : UTF-8


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


This service allows you to create a SMS campaign on a contact list or on a tag

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

  • Creating the campaign on a list of contacts or on your tagged contacts.
  • Getting the status of the campaign (calculating, ready to send, failed)
  • Deleting a list campaign
  • Validating sending a list campaign

Special parameters

list_namestringName of the list to be used for the campaign. (you can use tag_name instead)
tag_namestringName of the tag to be used to filter your contacts for the campaign. (you can use list_name instead)
textstringMessage text (from 1 to 1224 characters non unicode).
typestringCampaign Type : [“sms_vocal”]
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: “alert” or “wholesale”: [“alert”,”wholesale”]
with_repliesboolean“True” for getting back recipient replies
auto_optimize_textboolean(optional) By transmitting this field with “false” value, your text will not be optimized by Octopush robot (your message could contain unicode characters, or useless spaces that could increase the number of needed SMS for each contact).
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.

Example Curl

curl -X POST \ 
'' \ 
-H 'Content-Type: application/json' \ 
-H 'api-login: ******' \ 
-H 'api-key: ************' \ 
-H 'cache-control: no-cache' \ 
-d '{
  "list_name": "my_list",
  "text": "This is a Premium SMS with STOP. STOP at 30101",
  "type": "sms_premium",
  "purpose": "wholesale",
  "sender": "Company X"

Command to copy/paste

curl -X POST '' -H 'Content-Type: application/json' -H 'api-login: ******' -H 'api-key: ************' -H 'cache-control: no-cache' -d '{"list_name": "my_list", "text": "This is a Premium SMS with STOP. STOP at 30101", "type": "sms_premium", "purpose": "wholesale", "sender": "Company X"}'

JSON Server Response

Success : 201 CREATED

  "ticket_number": "sms_5f3fbce61266e" 

Failure : 400 BAD REQUEST

  "code": 121,
  "message": "Mention STOP is missing."