SMS API Integration
Take advantage of our new SMS gateway connection service with zero setup fees at iSMS Malaysia! With our SMS gateway, you can easily automate your bulk text messaging and integrate our iSMS API into any website or application.
Our iSMS API (Application Programming Interface) has been specially designed by our group of innovative team of engineers, to provide a straightforward yet effective, method of integrating websites and software with our messaging platform. Making it perfectly suitable for both small and large corporate information systems.
In order to use iSMS API to send mass SMS, you have to initiate a HTTPS request (POST/GET method).
SMS API Quick Links
iSMS API - Send SMS
| 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 |
* MUST URL Encoded 
*** Please ENSURE adding on agreeterm parameter e.g. agreedterm=YES into your API with "Terms and Condition" reference above.
*** We STRONGLY recommend our client set all the mirror link below into system to ensure high availablity.
*** SMS credit will be charged regardless of delivery status and number of SMS.
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
Send SMS by Phone Number to Single Recipient via HTTPS:
https://ww3.isms.com.my/isms_send_all_id.php?un=isms&pwd=isms&dstno=60123456789&msg=Hello%20World&type=1&sendid=12345
Multiple Recipient
Separate each recipient with semi-colon(;) Suggest maximum 30 number per push
Send SMS by Phone Number to Multiple Recipient via HTTPS:
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
Return Values :- 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 is failed, you'll get a error code and error description like below :-
-1004 = INSUFFICIENT CREDITS
| Error Code |
Error Description |
Details |
| 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 |
API for Checking SMS Balance
In order to check balance API :-
| Parameter |
Details |
Example |
| *un |
Username of iSMS account |
isms |
| *pwd |
Password of iSMS account |
isms123 |
Check Balance via HTTPS:
https://ww3.isms.com.my/isms_balance.php?un=isms&pwd=isms123
API for Checking Account Expired Date
In order to check account expired date API :-
| Parameter |
Details |
Example |
| *un |
Username of iSMS account |
isms |
| *pwd |
Password of iSMS account |
isms123 |
Check Account Expired Date via HTTPS:
https://ww3.isms.com.my/isms_expiry_date.php?un=isms&pwd=isms123
System will return Scheduler ID after success.(Scheduler ID will use to Update and Delete)
| Parameter
| Description
| Sample
|
| *un |
Your iSMS Username |
isms |
| *pwd |
Your iSMS Password |
isms |
| *dstno |
Destination Number |
60121234567,60191234567 |
| *msg |
Message |
Hello ISMS |
| *det |
Task Description |
TEST |
| *tr |
Trigger(onetime, daily, weekly, monthly) |
onetime |
| *type |
1 or 2 (1 = normal, 2 = unicode) |
1 |
| *sendid |
Sender ID |
isms |
| *date |
Start Date (YYYY-MM-DD) |
2024-11-24 |
| *hour |
Hour (00 - 23) |
08 |
| *min |
Minute (00, 15, 30, 45) |
15 |
| *week |
Day of week (1 - 7) |
1 |
| *month |
Month (1 - 12) |
1 |
| *day |
Day of month (1 - 31) |
1 |
Update Task Schedule via HTTPS:
https://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&dstno=60123456789&msg=Hello%20World&det=My%2Task&tr=onetime&type=1&sendid=12345&date=2024-11-24&hour=08&min=15&week=1&month=1&day=1&scid=98765&action=update
| Parameter
| Description
| Sample
|
| *un |
Your iSMS Username |
isms |
| *pwd |
Your iSMS Password |
isms |
| *dstno |
Destination Number |
60121234567,60191234567 |
| *msg |
Message |
Hello ISMS |
| *det |
Task Description |
TEST |
| *tr |
Trigger(onetime, daily, weekly, monthly) |
onetime |
| *type |
1 or 2 (1 = normal, 2 = unicode) |
1 |
| *sendid |
Sender ID |
isms |
| *date |
Start Date (YYYY-MM-DD) |
2024-11-24 |
| *hour |
Hour (00 - 23) |
08 |
| *min |
Minute (00, 15, 30, 45) |
15 |
| *week |
Day of week (1 - 7) Monday - Sunday |
1 |
| *month |
Month (1 - 12) |
1 |
| *day |
Day of month (1 - 31) |
1 |
| *scid |
Scheduler ID |
123456 |
| *action |
Action Parameter |
update |
Delete Task Schedule via HTTPS:
https://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&scid=98765&action=delete
| Parameter
| Description
| Sample
|
| *un |
Your iSMS Username |
isms |
| *pwd |
Your iSMS Password |
isms |
| *scid |
Scheduler ID - return value from create new task scheduler |
123456 |
| *action |
Action Parameter |
delete |
URL Encoding Reference
| ASCII Character |
Description |
URL-encoding |
Remark |
| NUL |
null character |
%00 |
|
| CR |
carriage return |
%0D |
For Break Line used |
Security
Bulk SMS Malaysia provides secure messaging using SSL encryption technology.
|
iSMS Rates
Customised SMS Integration
Need Support?
