SMS API Integration

Take advantage of our SMS gateway connection service with zero setup fees

Powerful SMS API Solutions

Our iSMS API (Application Programming Interface) has been specially designed by our innovative team of engineers to provide a straightforward yet effective method of integrating websites and software with our messaging platform. Perfect for both small businesses and large corporate information systems.

With our SMS gateway, you can easily automate your bulk text messaging and integrate our iSMS API into any website or application.

HTTP API - Send SMS

To use iSMS API to send mass SMS, you have to initiate a HTTPS request (POST/GET method).

Parameters

Parameter	Details	Example
*un	Username of iSMS account	isms
*pwd	Password of iSMS account	isms123
dstno	Mobile number that you wish to send a message (Append 00 for international numbers)	6012xxxxxxxx
*msg	The message body (MAX limit : 700 char)	Hi, John. How r u?
type	Type of SMS 1 - ASCII (English, Bahasa Melayu, etc) 153 characters 2 - Unicode (Chinese, Japanese, etc) 63 Characters	1
*agreedterm	Agreed iSMS Term and Condition below: https://www.isms.com.my/user-agreement.php API will filter your sms if you do not agreed with the agreement.	YES
*sendid (Optional)	Sender ID to be displayed on recipient's mobile phone. (A to z 0 to 9 only) Maximum 11 characters (Please notice that Malaysia Prefix does not support Sender ID)	61000

Note: * MUST URL Encoded HTTP Response Result. Please ENSURE adding on agreeterm parameter e.g. agreedterm=YES into your API with "Terms and Condition" reference above.

Tip: We STRONGLY recommend our client set all the mirror link below into system to ensure high availability. SMS credit will be charged regardless of delivery status and number of SMS.

API Endpoints

                    Send SMS API via HTTPS:

                    https://www.isms.com.my/isms_send_all_id.php

                    Send SMS API via HTTPS (mirror 1):

                    https://ww3.isms.com.my/isms_send_all_id.php

                    Send SMS API via HTTPS (mirror 2):

                    https://smtpapi.vocotext.com/isms_send_all_id.php

Example Requests

Single Recipient

                    https://www.isms.com.my/isms_send_all_id.php?un=isms&pwd=isms&dstno=60123456789&msg=Hello%20World&type=1&sendid=12345
                

Multiple Recipients

Separate each recipient with semi-colon(;). Suggest maximum 30 numbers per push.

                    https://ww3.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=phone1;phone2;phone3&msg=Hello%20World&type=1&sendid=12345
                

Server Response

Upon message submission, iSMS's server platform will provide the user with a corresponding response value for each message.

If the SMS has been successfully sent, you'll get a response like below:

2000 = SUCCESS or EMPTY/BLANK

However, if the SMS failed, you'll get an error code and error description like below:

-1004 = INSUFFICIENT CREDITS

Error Codes

2000	SUCCESS:SMS ID or EMPTY/BLANK	SUCCESS - Message Sent.
-1000	UNKNOWN ERROR	Unknown error. Please contact the administrator.
-1001	AUTHENTICATION FAILED	Your username or password are incorrect.
-1002	ACCOUNT SUSPENDED / EXPIRED	Your account has been expired or suspended. Please contact the administrator.
-1003	IP NOT ALLOWED	Your IP is not allowed to send SMS. Please contact us to whitelist IP.
-1004	INSUFFICIENT CREDITS	You have run out of credits. Please reload your credits.
-1005	INVALID SMS TYPE	Your SMS type is not supported.
-1006	INVALID BODY LENGTH (1-900)	Your SMS body has exceed the length. Max limit = 900
-1007	INVALID HEX BODY	Your Hex body format is wrong.
-1008	MISSING PARAMETER	One or more required parameters are missing.
-1009	INVALID DESTINATION NUMBER	Invalid number
-1012	INVALID MESSAGE TYPE	Message contain unicode and please use type=2 for Unicode
-1013	INVALID TERM AND AGREEMENT	Please add agreedterm=YES in your API.

REST API

https://www.isms.com.my/RESTAPI.php

Parameters

Property name	Type	Description	Sample
un	String	Username of iSMS account.
pwd	String	Password of iSMS account.
dstno	String	Destination addresses must be in international format (example: 60164502380).	60164502380
msg	String	Text of the message that will be sent.
type	Integer	Type of SMS 1. ASCII (English, Bahasa Melayu, etc) 2. Unicode (Chinese, Japanese, etc)	1
agreedterm	String	Agreed iSMS Term and Condition below: https://www.isms.com.my/user-agreement.php API will filter your sms if you do not agreed with the agreement.	Yes
sendid	String	Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (example: CompanyName).

Server Response

Upon message submission, iSMS's server platform will provide the user with a corresponding response value for each message.

If the SMS has been successfully sent, you'll get a response like below:

2000 = SUCCESS:trx_id

However, if the SMS failed, you'll get an error code and error description like below:

-1004 = INSUFFICIENT CREDITS

Error Codes

2000	SUCCESS:trx_id	SUCCESS push SMS to telco, trx_id is unique SMS ID.
-1000	UNKNOWN ERROR	Unknown error. Please contact the administrator.
-1001	AUTHENTICATION FAILED	Your username or password are incorrect.
-1002	ACCOUNT SUSPENDED / EXPIRED	Your account has been expired or suspended. Please contact the administrator.
-1003	IP NOT ALLOWED	Your IP is not allowed to send SMS. Please contact the administrator.
-1004	INSUFFICIENT CREDITS	You have run out of credits. Please reload your credits.
-1005	INVALID SMS TYPE	Your SMS type is not supported.
-1006	INVALID BODY LENGTH (1-700)	Your SMS body has exceed the length. Max limit = 700
-1007	INVALID HEX BODY	Your Hex body format is wrong.
-1008	MISSING PARAMETER	One or more required parameters are missing.
-1009	INVALID DESTINATION NUMBER	Invalid number
-1012	INVALID MESSAGE TYPE	Message contain unicode and please use type=2 for Unicode
-1013	INVALID TERM AND AGREEMENT	Please add agreedterm=YES in your API.

SMPP (Short Message Peer-to-Peer) API

SMPP, which stands for Short Message Peer-to-Peer, is a widely-used protocol within the telecommunications industry. It facilitates the exchange of SMS (Short Message Service) messages between various entities, including applications and SMS service providers. This standardized protocol is designed to ensure reliable and efficient communication when sending and receiving SMS messages.

For SMPP integration documentation and credentials, please contact our support team.

Contact Support

Two-Factor Authentication API

Integrating iSMS 2FA Two-Factor Authentication into your web applications or services will provide additional security to users while they use your applications. A One-Time Pin code will be sent to user via SMS to verify their identity and resume the process.

Key features of our 2FA API:

Instant OTP delivery to any mobile number
Customizable message templates
Detailed delivery reports
High availability infrastructure

Get 2FA API Documentation