SMS API Integration

iSMS Malaysia now offers you to connect to our SMS gateway without any setup fees. By, using our SMS gateway you can automate your bulk text messaging and integrate iSMS service into any website or application using our iSMS API.


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 HTTP / HTTPS request (POST/GET method).


SMS API Quick Links

API Link Reference Description Code Example
URL Encode - -
Send SMS Send SMS via HTTP / HTTPS
Server Response Return Values :- Upon message submission, iSMS's server platform will provide the user with a corresponding response value for each message. Server Response
Check Balance Check SMS Account's Balance
SMS Scheduler Set your SMS scheduler with HTTP API

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).
60123456789
*msg The message body (MAX limit : 900 char) Hi, John. How r u?
type Type of SMS
1 - ASCII (English, Bahasa Melayu, etc)
2 - Unicode (Chinese, Japanese, etc)
1
*sendid
(Optional)
Sender ID to be displayed on recipient's mobile phone.
(Please notice that Malaysia Prefix does not support Sender ID)
60198899001
* MUST URL EncodedHTTP Response Result


*** We STRONGLY recommend our client set all the mirror link below into system to ensure high availablity.


Send SMS API via HTTP:
http://www.isms.com.my/isms_send.php
Send SMS API via HTTPS:
https://www.isms.com.my/isms_send.php

Send SMS API via HTTP(mirror 1):
http://ww2.isms.com.my/isms_send.php
Send SMS API via HTTPS(mirror 1):
https://ww2.isms.com.my/isms_send.php

Send SMS API via HTTP(mirror 2):
http://www.vocotext.com/isms_send.php
Send SMS API via HTTPS(mirror 2):
https://www.vocotext.com/isms_send.php

Send SMS by Phone Number to Single Recipient via HTTP:
http://www.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=60123456789&msg=Hello%20World&type=1&sendid=12345
Send SMS by Phone Number to Single Recipient via HTTPS:
https://www.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=60123456789&msg=Hello%20World&type=1&sendid=12345

Send SMS by Group ID via HTTP:
http://www.isms.com.my/api_send_sms_by_group.php?un=isms&pwd=isms123&groupid=12345&msg=Hello%20World&type=1&sendid=12345
Send SMS by Group ID via HTTPS:
https://www.isms.com.my/api_send_sms_by_group.php?un=isms&pwd=isms123&groupid=12345&msg=Hello%20World&type=1&sendid=12345

Send SMS by Recipient Name via HTTP:
http://www.isms.com.my/api_send_sms_by_name.php?un=isms&pwd=isms&name=contact1&msg=Hello%20World&type=1
Send SMS by Recipient Name via HTTPS:
https://www.isms.com.my/api_send_sms_by_name.php?un=isms&pwd=isms&name=contact1&msg=Hello%20World&type=1


Multiple Recipient

Separate each recipient with semi-colon(;) maximum 300 number per push


Send SMS by Phone Number to Multiple Recipient via HTTP:
http://www.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=60123456789;601254888999;6044478955&msg=Hello%20World&type=1&sendid=12345
Send SMS by Phone Number to Multiple Recipient via HTTPS:
https://www.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=60123456789;601254888999;6044478955&msg=Hello%20World&type=1&sendid=12345


Contact List

Get Contact List Group via HTTP:
http://www.isms.com.my/api_list_of_contact_group.php?un=isms&pwd=isms123
Get Contact List Group via HTTPS:
https://www.isms.com.my/api_list_of_contact_group.php?un=isms&pwd=isms123

Get Contact List Based on the Group ID via HTTP:
http://www.isms.com.my/api_list_of_contact.php?un=isms&pwd=isms123&groupid=12345
Get Contact List Based on the Group ID via HTTPS:
https://www.isms.com.my/api_list_of_contact.php?un=isms&pwd=isms123&groupid=12345

Get All Contact List from Phone Book via HTTP:
http://www.isms.com.my/api_list_of_contact.php?un=isms&pwd=isms123
Get All Contact List from Phone Book via HTTPS:
https://www.isms.com.my/api_list_of_contact.php?un=isms&pwd=isms123


Contact Group

Create New Group via HTTP:
http://www.isms.com.my/api_add_contact_group.php?un=isms&pwd=isms123&name=group1
Create New Group via HTTPS:
https://www.isms.com.my/api_add_contact_group.php?un=isms&pwd=isms123&name=group1

Update Group Name via HTTP:
http://www.isms.com.my/api_edit_contact_group.php?un=isms&pwd=isms&name=mygroup&groupid=98765
Update Group Name via HTTPS:
https://www.isms.com.my/api_edit_contact_group.php?un=isms&pwd=isms&name=mygroup&groupid=98765

Delete Group via HTTP:
http://www.isms.com.my/api_delete_contact_group.php?un=isms&pwd=isms&groupid=98765
Delete Group via HTTPS:
https://www.isms.com.my/api_delete_contact_group.php?un=isms&pwd=isms&groupid=98765


Server Response

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

Error Code Error Description Details
2000 = SUCCESS 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 the administrator.
-1004 INSUFFICIENT CREDITS You have run our 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.
     


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 HTTP:
http://www.isms.com.my/isms_balance.php?un=isms&pwd=isms123
Check Balance via HTTPS:
https://www.isms.com.my/isms_balance.php?un=isms&pwd=isms123



API for SMS Task Scheduler

List All Task Schedule via HTTP:
http://www.isms.com.my/api_list_of_schedule.php?un=isms&pwd=isms123
List All Task Schedule via HTTPS:
https://www.isms.com.my/api_list_of_schedule.php?un=isms&pwd=isms123

Create New Task Schedule via HTTP:
http://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&dstno=60123456789&msg=Hello%20World&det=Task1&tr=onetime&type=1&sendid=12345&date=2017-01-23&hour=08&min=15&week=1&month=1&day=1
Create New Task Schedule via HTTPS:
https://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&dstno=60123456789&msg=Hello%20World&det=Task1&tr=onetime&type=1&sendid=12345&date=2017-01-23&hour=08&min=15&week=1&month=1&day=1


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) 2017-01-23
*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 HTTP:
http://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=2017-01-23&hour=08&min=15&week=1&month=1&day=1&scid=98765&action=update
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=2017-01-23&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) 2017-01-23
*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 HTTP:
http://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&scid=98765&action=delete
Delete Task Schedule via HTTPS:
http://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.


 

SMS Coverage for All Countries Worldwide

A B C D E F G H I J K L M N O P Q R S T U V Y Z
divider