Send SMS messages

This request is used to send real-time or delayed SMS messages.

URLs

POST https://api.smspartner.fr/v1/send

Parameters

Each API request supports the following parameters:

The platform does not send commercial SMS messages between 10pm and 8am during the week and on Sundays and public holidays (legal restriction). In case of sending, the SMS messages are on pause until the next business day at 8am.
You do not send commercial SMS messages? Contact us: help@smspartner.fr

apiKey	API key of your account. You get it in your SMS Partner account.
phoneNumbers	Telephone numbers of the recipients. When sending several SMS messages, the numbers must be separated by commas. They can be: in national (06xxxxxxxxxxxx) or international (+336xxxxxxxxxx) format, for French numbers. in international format (+496xxxxxxxxxx), for numbers outside France.
message	SMS content. 160 characters maximum per SMS (beyond that, you will be charged one additional SMS per 153 characters). Be careful, some special and accented characters will be replaced when sending: Consult the list `\r\n` Allows you to make a line break. `The STOP SMS mention is mandatory for SMS with commercial characters (see parameter isStopSms below)`
Optional parameters
gamme	SMS range, its value must be: 1 for Premium SMS 2 for Low Cost SMS If this parameter is omitted, SMS will be sent in the Premium range.
sender	Name of the sender of the message. If the sender is left empty, your SMS messages will be sent with an operator shortcode as sender (example: 36xxx). The number of characters for the transmitter name must be between 3 and 11 inclusive and must not contain any special characters. Some mobile phone models do not interpret spaces.
scheduledDeliveryDate	Date of sending of the SMS, in `dd/mm/YYYY` format. To be defined only if you want SMS to be sent offline.
time	SMS sending time (format 0-24), mandatory if `scheduledDeliveryDate` is set.
minute	SMS sending time regarding minutes units (format 0-55, per five-minute interval), mandatory if `scheduledDeliveryDate` is defined.
isStopSms	Premium range: 1 to add the mention STOP at the end of the SMS (mandatory for commercial SMS). Low Cost range: This parameter is not applicable for this range, it is necessary to manually add the mention NoPub=STOP for commercial SMS.
sandbox	To test sending SMS, you can use the`sandbox`: 1 setting to enable sandbox mode No SMS will be sent, and there will be no debit to your account, these SMS will be deleted from your mailing lists automatically every day.
_format	Response format. You can choose between `JSON` or `XML`. By default, the response format is `JSON`.

Request

Request example:

<?php
        // Prepare data for POST request
        $fields = array(
            'apiKey'=> 'YOUR API KEY',
            'phoneNumbers'=> '+336xxxxxxxx',
            'message'=> 'This is your message',
            'sender' => 'mycompany',
            'scheduledDeliveryDate'=> '21/10/2014',
            'time'=> 9,
            'minute'=> 0
        );
 
 
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/send');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_TIMEOUT, 10);
        curl_setopt($curl, CURLOPT_POST, 1);
        curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields));
 
        $result = curl_exec($curl);
        curl_close($curl);
 
        // Process your response here
        echo $result;
?>

<?php

// Prepare data for POST request

$fields = array(

'apiKey'=> 'YOUR API KEY',

'phoneNumbers'=> '+336xxxxxxxx',

'message'=> 'This is your message',

'sender' => 'mycompany',

'scheduledDeliveryDate'=> '21/10/2014',

'time'=> 9,

'minute'=> 0

);

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/send');

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

curl_setopt($curl, CURLOPT_TIMEOUT, 10);

curl_setopt($curl, CURLOPT_POST, 1);

curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields));

$result = curl_exec($curl);

curl_close($curl);

// Process your response here

echo $result;

Imports System.IO
Imports System.Net
 
Module Module1
 
  Sub Main()
 
    Dim base_url As String = "http://api.smspartner.fr/v1/"
    Dim apiKey As String = "VOTRE_APIKEY"
 
    #send sms
    url = base_url & "send"
    #note : utiliser une librairie JSON en production, par exemple :
    #https//www.nuget.org/packages/Newtonsoft.Json/
    Dim parameters As String = String.Format(
        "{{""apiKey"":""{0}"",""phoneNumbers"":""{1}"",""message"":""{2}""}}",
        apiKey,
        "+33XXXXXXXXX",
        "message de test")
    Console.Write(parameters)
    apiRequest("POST", url, parameters)
 
  End Sub
 
  Function apiRequest(method As String, url As String, parameters As String) As String
 
    Dim request As HttpWebRequest
    request = WebRequest.Create(url)
    request.Method = method
    request.Timeout = 10000   # timeout in ms
    request.ContentType = "application/json; charset=utf-8"
    request.ContentLength = 0
 
    #set POST data
    If Not String.IsNullOrEmpty(parameters) Then
      request.ContentLength = parameters.Length
      Using reqStream As StreamWriter = New StreamWriter(request.GetRequestStream())
        reqStream.Write(parameters)
      End Using
    End If
 
    #get response
    Dim returnValue As String = Nothing
    Using response As HttpWebResponse = request.GetResponse()
      If response.StatusCode = HttpStatusCode.OK Then
        Using resStream = response.GetResponseStream()
          If resStream IsNot Nothing Then
            Using reader As New StreamReader(resStream)
              returnValue = reader.ReadToEnd()
            End Using
          End If
        End Using
      End If
    End Using
    apiRequest = returnValue
 
  End Function
 
End Module

Imports System.IO

Imports System.Net

Module Module1

Sub Main()

Dim base_url As String = "http://api.smspartner.fr/v1/"

Dim apiKey As String = "VOTRE_APIKEY"

#send sms

url = base_url & "send"

#note : utiliser une librairie JSON en production, par exemple :

#https//www.nuget.org/packages/Newtonsoft.Json/

Dim parameters As String = String.Format(

"{{""apiKey"":""{0}"",""phoneNumbers"":""{1}"",""message"":""{2}""}}",

apiKey,

"+33XXXXXXXXX",

"message de test")

Console.Write(parameters)

apiRequest("POST", url, parameters)

End Sub

Function apiRequest(method As String, url As String, parameters As String) As String

Dim request As HttpWebRequest

request = WebRequest.Create(url)

request.Method = method

request.Timeout = 10000 # timeout in ms

request.ContentType = "application/json; charset=utf-8"

request.ContentLength = 0

#set POST data

If Not String.IsNullOrEmpty(parameters) Then

request.ContentLength = parameters.Length

Using reqStream As StreamWriter = New StreamWriter(request.GetRequestStream())

reqStream.Write(parameters)

End Using

End If

#get response

Dim returnValue As String = Nothing

Using response As HttpWebResponse = request.GetResponse()

If response.StatusCode = HttpStatusCode.OK Then

Using resStream = response.GetResponseStream()

If resStream IsNot Nothing Then

Using reader As New StreamReader(resStream)

returnValue = reader.ReadToEnd()

End Using

End If

End Using

End If

End Using

apiRequest = returnValue

End Function

End Module

# std
import logging
import json
from collections import OrderedDict
 
# 3p
import requests
 
API_KEY = "MY API KEY"
URL = "https://api.smspartner.fr/v1"
 
class SMSPartner():
    def send_sms(self,phone_numbers, msg, sender = "SMSPartner"):
		#sender = "DEMOSMS"
		print(phone_numbers)
 
		data = OrderedDict([
			("apiKey", API_KEY),
			("phoneNumbers", phone_numbers),
			("message", msg),
			("sender", sender)
		])
 
		url = URL + "/send"
		r = requests.post(url, data=json.dumps(data), verify=False)
 
		r_json = r.json()
		if r_json.get("success") == True:
			print(r_json)
			status = True
		else:
			print("SMS msg {} not delivered to {}".format(msg, phone_numbers))
			status = False
		return status

# std

import logging

import json

from collections import OrderedDict

# 3p

import requests

API_KEY = "MY API KEY"

URL = "https://api.smspartner.fr/v1"

class SMSPartner():

def send_sms(self,phone_numbers, msg, sender = "SMSPartner"):

#sender = "DEMOSMS"

print(phone_numbers)

data = OrderedDict([

("apiKey", API_KEY),

("phoneNumbers", phone_numbers),

("message", msg),

("sender", sender)

])

url = URL + "/send"

r = requests.post(url, data=json.dumps(data), verify=False)

r_json = r.json()

if r_json.get("success") == True:

print(r_json)

status = True

else:

print("SMS msg {} not delivered to {}".format(msg, phone_numbers))

status = False

return status

curl -H  "Content-Type: application/json" -X POST -d '{"apiKey":"xxxxx","phoneNumbers":"xxxx","message":"test","sender":"mycompany"}' https://api.smspartner.fr/v1/send

1	curl -H "Content-Type: application/json" -X POST -d '{"apiKey":"xxxxx","phoneNumbers":"xxxx","message":"test","sender":"mycompany"}' https://api.smspartner.fr/v1/send

{
   "success":true,
   "code":200,
   "message_id":307,
   "nb_sms": 1,
   "cost": 0.038,
   "currency": "EUR"
}

{

"success":true,

"code":200,

"message_id":307,

"nb_sms": 1,

"cost": 0.038,

"currency": "EUR"

}

<?xml version='1.0' encoding='UTF-8'?>
<result>
  <entry>true</entry>
  <entry>200</entry>
  <entry>306</entry>
  <entry>1</entry>
  <entry>0.038</entry>
  <entry>
        <![CDATA[EUR]]>
  </entry>
</result>

<?xml version='1.0' encoding='UTF-8'?>

<entry>

<![CDATA[EUR]]>

</entry>

</result>

Errors

Error messages examples:

JSON
XML

{
    "success": false,
    "code":9,
    "error": [{
        "elementId": "children[message].data",
        "message": "Le message est requis"
    }, {
        "elementId": "children[phoneNumbers].data",
        "message": "Ce numero de telephone n'est pas valide (922264)"
    }, {
        "elementId": "children[sender].data",
        "message": "L'emetteur ne peut pas etre plus long que 11 caracteres"
    }, {
        "elementId": "children[scheduledDeliveryDate].data",
        "message": "La date (21/11/2014 \u00e0 :) est anterieure a la date actuelle."
    }, {
        "elementId": "children[minute].data",
        "message": "La minute est requise"
    }, {
        "elementId": "children[time].data",
        "message": "L'heure est requise"
    }]
}

{

"success": false,

"code":9,

"error": [{

"elementId": "children[message].data",

"message": "Le message est requis"

}, {

"elementId": "children[phoneNumbers].data",

"message": "Ce numero de telephone n'est pas valide (922264)"

}, {

"elementId": "children[sender].data",

"message": "L'emetteur ne peut pas etre plus long que 11 caracteres"

}, {

"elementId": "children[scheduledDeliveryDate].data",

"message": "La date (21/11/2014 \u00e0 :) est anterieure a la date actuelle."

}, {

"elementId": "children[minute].data",

"message": "La minute est requise"

}, {

"elementId": "children[time].data",

"message": "L'heure est requise"

}]

}

<?xml version='1.0' encoding='UTF-8'?>
 <result>
          <entry>false</entry>
          <entry>9</entry>
          <entry>
                <entry>
                  <entry>children[message].data</entry>
                  <entry>Le message est requis</entry>
                </entry>
                <entry>
                   <entry>children[phoneNumbers].data</entry>
                   <entry>Ce numéro de téléphone n'est pas valide (922264)</entry>
                </entry>
                <entry>
                    <entry>children[sender].data</entry>
                    <entry>L'émetteur ne peut pas être plus long que 11 caractères</entry>
                </entry>
                <entry>
                    <entry>children[scheduledDeliveryDate].data</entry>
                    <entry>La date (21/11/2014 à :) est anterieure à la date actuelle. Si vous souhaitez l'envoyer maintenant vous devez sélectionner [Envoi immédiat]</entry>
                </entry>
                <entry>
                    <entry>children[minute].data</entry>
                    <entry>La minute est requise</entry>
                </entry>
                <entry>
                    <entry>children[time].data</entry>
                    <entry>L'heure est requise</entry>
                </entry>
      </entry>
</result>

<?xml version='1.0' encoding='UTF-8'?>

<entry>false</entry>

<entry>

<entry>children[message].data</entry>

<entry>Le message est requis</entry>

</entry>

<entry>

<entry>children[phoneNumbers].data</entry>

<entry>Ce numéro de téléphone n'est pas valide (922264)</entry>

</entry>

<entry>

<entry>children[sender].data</entry>

<entry>L'émetteur ne peut pas être plus long que 11 caractères</entry>

</entry>

<entry>

<entry>children[scheduledDeliveryDate].data</entry>

<entry>La date (21/11/2014 à :) est anterieure à la date actuelle. Si vous souhaitez l'envoyer maintenant vous devez sélectionner [Envoi immédiat]</entry>

</entry>

<entry>

<entry>children[minute].data</entry>

<entry>La minute est requise</entry>

</entry>

<entry>

<entry>children[time].data</entry>

<entry>L'heure est requise</entry>

</entry>

</result>

Control Code

	Error Codes
1	The API Key is required
2	The telephone number is required
9	At least one constraint was not respected during the sending: The transmitter cannot be longer than 11 characters. Invalid phone number. If scheduledDeliveryDate is set: The date (dd/mm/yyyyy) is before the current date. The minute is required. The time is required.
10	Invalid API Key
11	Lack of funds

Unit sending

Send SMS messages

URLs

POST https://api.smspartner.fr/v1/send

Parameters

Request

Answers

Errors

Control Code