SMS API: add text messaging to your applications
Notifications, alerts, verification codes, campaigns and conversations: control all your SMS from your website, app or business software with a documented REST API.
- REST API, OpenAPI 3.0 specification
- HMAC-SHA256 signed requests
- Delivery receipts via webhook
# CK = Client Key, AK = Auth Key
TS=$(date +%s000)
SIG=$(printf '%s' "$CK$TS" \
| openssl dgst -sha256 -hmac "$AK" \
| cut -d' ' -f2)
curl https://api.smsreflex.com/api/messages \
-H "X-Auth-Ck: $CK" \
-H "X-Auth-Ak: $AK" \
-H "X-Auth-Ts: $TS" \
-H "X-Auth-Signature: $SIG" \
--data-urlencode "To=33612345678" \
--data-urlencode "From=MYSHOP" \
--data-urlencode "MessageText=Your order is ready!"What you can do with the API
The same features as the online platform, available from your code.
-
SMS sending and status
Send an SMS in one request, with the sender name of your choice (11 characters), then track its delivery status.
POST /api/messages -
Verification codes (OTP)
Generate and send a 4 to 8-digit code, valid for 2 to 60 minutes, then check the code entered by the user.
POST /api/verification/send -
Webhooks
Receive delivery receipts and account events directly on your server.
POST /api/store-webhook -
Campaigns
Create campaigns, import your contact lists as CSV and track sending statistics.
POST /api/new-campaigns -
Conversations (Time2chat)
Read your account's two-way conversations and reply to your contacts through the API.
POST /api/chat/reply -
Short URLs and click tracking
Generate short links for your SMS and measure clicks, day by day or click by click.
POST /api/shorturls -
Contacts and opt-outs
List your contacts by status and update their status, including opt-outs (STOP).
GET /api/contacts/list -
Statistics and credits
Get your volumes by status, count a message's segments before sending and check your credit balance.
GET /api/stats
SMS triggered by your applications
Transactional notifications
Order confirmations, shipping updates, appointment reminders: triggered by your software at the right moment.
Alerts
Incident, threshold exceeded, status change: an SMS goes out as soon as your system detects the event.
Two-factor authentication
OTP codes for sign-up, login or confirming a sensitive action.
Automated marketing
Campaigns and follow-ups driven by your CRM or online shop, with click tracking.
Get started in three steps
-
Create your account
Open your SMS Reflex account and choose a plan that includes API access.
-
Get your keys
Your Client Key and Auth Key are used to sign every request.
-
Send your first SMS
Follow the documentation: every endpoint is described with its parameters and sample responses.
SMS API FAQ
How do I authenticate with the SMS Reflex API?
Every request is signed with 4 HTTP headers: your Client Key (X-Auth-Ck), your Auth Key (X-Auth-Ak), a timestamp in milliseconds (X-Auth-Ts) and an HMAC-SHA256 signature computed with your Auth Key (X-Auth-Signature).
Which plan includes the API?
API access is included in the 2200 Plan France plan. For higher volumes, contact us for a custom offer.
Can I send verification codes (OTP)?
Yes. The API generates a 4 to 8-digit code, sends it by SMS in French, English, Spanish or Italian, keeps it for 2 to 60 minutes and then checks the code entered by the user.
How do I get an SMS delivery status?
Query a message's status using its ID, or set up a webhook to receive delivery receipts automatically on your server.
Can I customise the SMS sender?
Yes, with an alphanumeric sender name of up to 11 characters (your brand name, for example).
Where can I find the full documentation?
The reference documentation (OpenAPI 3.0) is public at api.smsreflex.com: every endpoint is described with its parameters, responses and examples.
An SMS integration project?
Tell us what you need: volumes, use cases, technical constraints. We will get back to you with a tailored proposal.