A step-by-step guide to sending SMS via the iSMS API using Postman — POST request with x-www-form-urlencoded body.
Make sure you have the following ready:
The iSMS SMS API uses a POST request with x-www-form-urlencoded body. Endpoint:
| Parameter | Description | Required |
|---|---|---|
| un | Your iSMS username | ✅ Yes |
| pwd | Your iSMS password | ✅ Yes |
| dstno | Recipient number in international format without + (e.g. 60123456789) | ✅ Yes |
| msg | Your SMS message text | ✅ Yes |
| type | 1 = ASCII (Normal), 2 = Unicode (Chinese, Arabic, etc.) | ✅ Yes |
| sendid | Sender name — max 11 characters (optional, subject to approval) | ❌ Optional |
| agreedterm | Must be set to "YES" to confirm acceptance of terms | ✅ Yes |
Open Postman. Click "New" → "HTTP Request". Set the method to POST.
Enter the endpoint URL:
Click the "Body" tab. Select "x-www-form-urlencoded" (not raw, not form-data). Add each parameter as a key-value pair:
| Key | Value (example) |
|---|---|
| un | myusername |
| pwd | mypassword |
| dstno | 60123456789 |
| msg | Hello World! Your OTP is 123456. |
| type | 1 |
| sendid | MyCompany |
| agreedterm | YES |
Click "Send". A successful response looks like:
| Response Code | Description |
|---|---|
| 2000 | SUCCESS:{TRX_ID} — Message accepted and pushed to telco. TRX_ID is the unique transaction identifier for delivery tracking. |
| -1000 | Unknown Error — An unspecified error occurred on the server side. |
| -1001 | Authentication Failed — Invalid username or password. |
| -1002 | Account Suspended / Expired — The account is inactive or has expired. |
| -1003 | IP Not Allowed — The originating IP address is not whitelisted for this account. |
| -1004 | Insufficient Credits — The account does not have enough SMS credits. |
| -1005 | Invalid SMS Type — The type parameter value is not 1 or 2. |
| -1006 | Invalid Body Length — Message body exceeds allowed character limit. |
| -1007 | Invalid Hex Body — The Unicode hex-encoded message body is malformed. |
| -1008 | Missing Parameter — One or more required parameters are absent from the request. |
| -1009 | Invalid Destination Number — The dstno value is not a valid international format number. |
| -1012 | Invalid Message Type — The method or message type field is unrecognised. |
| -1013 | Invalid Term and Agreement — agreedterm is not set to YES. |