Single Send
This request is used to send SMS in real-time or scheduled.
URL
POST
https://api.smspartner.fr/v1/send
The platform does not send marketing SMS between 8 PM and 8 AM on weekdays, as well as on Sundays and public holidays (legal restriction). If a message is sent during that time, it will be on hold until the next working day at 8 AM. Not sending marketing SMS? Contact us to disable this restriction: help@smspartner.fr
Required Parameters
apiKey
phoneNumbers
Recipient phone numbers. To send to multiple recipients, separate numbers with commas. Maximum of 500 numbers per request. Supported formats:
National (06xxxxxxxx) or international (+336xxxxxxxx) for French numbers.
International (+496xxxxxxxx) for numbers outside France.
message
SMS content. 160 characters max per SMS (additional SMS units will be charged per 153-character segment beyond that).
Line break → :br: Note: Line break counts as two characters.
€ symbol → :euro:
The character ” must be escaped (\”) for the SMS to be valid. Otherwise, a 400 error will be returned.
Some Special Characters will be replaced upon sending. Please review them.
Optional Parameters
sender
Sender name. If left empty, SMS will be sent using a short operator code (e.g., 36xxx).
Sender name must be between 3 and 11 characters, no special characters allowed. Note: Some mobile devices may not display spaces properly.
tag
String up to 20 characters, no spaces, lowercase only
scheduledDeliveryDate
dd/mm/YYYY (scheduled delivery)
time
Format: 0–24 (delivery hour)
If scheduledDeliveryDate
is set, this parameter is required
minute
Format: 0–55 (5-min intervals)
If scheduledDeliveryDate
is set, this parameter is required
urlResponse
URL to receive SMS replies (e.g., http://www.myresponseurl.com)
urlDlr
URL to receive delivery reports (e.g., http://www.mydlrurl.com)
isStopSms
1
to add STOP notice at the end of SMS (mandatory and automatic for marketing SMS)
isUnicode
If set to 1: Enables Unicode mode (max 70 characters per SMS).
Note: Unicode SMS must be enabled on your account by an administrator. Contact support to enable this feature.
sandbox
1
for Sandbox Mode
_format
json
or xml
Requests
Response
Errors
Error Codes
1
API Key is required
2
Phone number is required
9
One or more constraints were not met during sending: - Sender cannot exceed 11 characters - Invalid phone number - If <code>scheduledDeliveryDate</code> is set: The date is earlier than the current date. Minute is required. Hour is required.
10
Invalid API Key
11
Insufficient credits
Last updated