In short
The Digital Connect SMS API lets a business in Saudi Arabia send SMS from its own systems. It supports three connection methods, REST, SMPP and SOAP, and sends every message under a sender name registered for that business. Each message returns a delivery report. Access is given after the business account and sender name are set up.
Three ways to connect
All three connect your systems to the same platform. Choose by your volume and by what your system already supports.
| Method | When it fits | What you need |
|---|---|---|
| REST API | Application traffic: sign-up codes, order updates and events from your app | Standard web development skills and servers on your IP whitelist |
| SMPP | Sustained high-volume sending, or systems built around telecom protocols | An SMPP client and the bind details agreed during onboarding |
| SOAP | An existing business system, such as an ERP, that supports SOAP and nothing else | The service description and credentials we provide with access |
A REST request that sends one message looks like this. YOUR_API_KEY stands for the key you receive with API access.
curl -X POST https://api.connect.interkey.com.sa/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+966501234567",
"from": "YourBrand",
"message": "Your OTP is 123456"
}'
What you can send
- OTP and verification codes for sign-up, login and payment confirmation.
- Operational alerts about a customer's own order, account or service.
- Campaigns to customers who chose to receive them.
- Reminders for appointments and due dates.
From request to first message
- Request API access through the form on this page.
- Set up the account and sender name. Interkey registers your sender name during onboarding.
- Receive the connection details and agree the IP addresses that may connect, or a VPN connection.
- Send test messages in Arabic and English and check them on real phones before full volume.
Delivery reports and callbacks
A delivery report tells you whether a message reached the recipient's phone, failed, or is still pending. That is different from the provider accepting the message for sending. Digital Connect gives a delivery receipt for each message, reports on performance and delivery results in the platform that you can export, and delivery callbacks that send the status to your own system. Your OTP, alert and reminder flows can then act on the result, for example by offering a new code when a message fails. Ask us how delivery statuses reach your system on the route you choose.
SMS delivery reports explained
Security
Your servers connect from whitelisted IP addresses or over a VPN connection, so a leaked credential alone cannot connect from an address that is not on your list. Keep API credentials on your servers, never inside a mobile app or browser code. Platform users sign in with two-factor authentication and work at admin or user level, templates are approved by your team and by Interkey, and your account has fraud protection, country blocking and spending limits.
Arabic messages and length
Arabic text is sent in Unicode, so one SMS holds 70 characters and each part of a longer message holds 67. English text in GSM-7 fits 160 characters, or 153 per part. Each part counts as a message, so check long templates before you send them at volume.
Questions about the SMS API
What is an SMS API?
An SMS API is an interface that lets your system send SMS automatically through a provider, without anyone typing messages by hand. Your application calls it when something happens, such as a login or an order, and the message goes out under your registered sender name with a delivery report.
Which SMS API should I use: REST, SMPP or SOAP?
REST suits most applications, SMPP suits sustained high volume, and SOAP suits existing business systems that support nothing else. Start from your volume and from what your system already supports; you can start on REST and discuss SMPP as your volume grows. SMPP vs REST SMS API
Do I need a registered sender name to use the API?
Yes. Every message goes out under a sender name registered for your company, and Interkey handles the registration during onboarding. Send SMS under your company name
How do I know a message was delivered?
Each message returns a delivery report that says whether it was delivered, failed or is still pending. You can see it in the platform, export it, or receive it in your own system. SMS delivery reports
How is the SMS API priced?
By quote, based on your monthly volume and the type of messages you send. OTP and promotional traffic are priced separately. How SMS pricing works
