Integration · SMS API

SMS API for businesses in Saudi Arabia

Send OTPs, alerts and campaigns from your own systems by REST, SMPP or SOAP, under your registered sender name, with a delivery report for every message.

  • Registered sender names
  • 99.9% uptime guaranteed
  • Delivery report for every message

Direct Carrier Partners

STCMobilyZain

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.

SMS API connection methods
MethodWhen it fitsWhat you need
REST APIApplication traffic: sign-up codes, order updates and events from your appStandard web development skills and servers on your IP whitelist
SMPPSustained high-volume sending, or systems built around telecom protocolsAn SMPP client and the bind details agreed during onboarding
SOAPAn existing business system, such as an ERP, that supports SOAP and nothing elseThe 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

From request to first message

  1. Request API access through the form on this page.
  2. Set up the account and sender name. Interkey registers your sender name during onboarding.
  3. Receive the connection details and agree the IP addresses that may connect, or a VPN connection.
  4. Send test messages in Arabic and English and check them on real phones before full volume.

Get a price for your 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.

Secure SMS gateway controls

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.

SMS segment calculator

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

Request API access

Tell us what you will send, your expected monthly volume and which connection method your system supports. We will reply with the onboarding steps and a quote for your traffic.

  1. We read your message
  2. We ask about your volume and message types
  3. You get a written quote

By sending this form, you agree to our Privacy Notice.