Home›WABA API›Postman Guide

💬 How to Test iSMS WABA API Using Postman

A step-by-step guide to testing the iSMS WhatsApp Business API using Postman — from authentication to sending your first template message.

Before You Start

Make sure you have the following ready:

⚠️ WhatsApp Template Requirement: All outbound marketing and notification messages via WABA must use a pre-approved WhatsApp message template. You cannot send free-form text unless the recipient has initiated the conversation within the last 24 hours (Service messaging window).

Step-by-Step: Send a WABA Template Message via Postman

1

Open Postman and Create a New Request

Launch Postman. Click "New" → "HTTP Request". Set the method to POST.

2

Enter the WABA API Endpoint

In the URL field, enter the iSMS WABA API endpoint:

https://ww3.isms.com.my/isms_send_waba.php
3

Set the Request Body

Click the "Body" tab → select "raw" → choose "JSON". No separate Authorization header is needed — your credentials are passed inside the JSON body. Enter the following:

{ "AppId": "your_app_id", "AppSecret": "your_app_secret", "un": "your_username", "pwd": "your_password", "agreedterm": "YES", "Type": "message", "Content": "Hello! Your order has been confirmed.", "Language": "en", "From": "your_waba_number", "To": "60123456789" }
FieldDescriptionRequired
AppIdYour WABA App ID from iSMS dashboard✅ Yes
AppSecretYour WABA App Secret from iSMS dashboard✅ Yes
unYour iSMS username✅ Yes
pwdYour iSMS password✅ Yes
agreedtermMust be set to "YES" to confirm acceptance of terms✅ Yes
TypeMessage type — use "message" for standard sending✅ Yes
ContentThe message text to send✅ Yes
LanguageLanguage code e.g. "en", "ms", "zh"✅ Yes
FromYour registered WABA sender number✅ Yes
ToRecipient WhatsApp number with country code e.g. 60123456789✅ Yes
4

Send the Request

Click "Send". Postman will display the API response below.

5

Check the Response

A successful response will return HTTP 200 with a message ID:

{ "status": "success", "message_id": "wamid.XXXXXXXXXXXXXXXX" }
✅ Status: success means your WhatsApp message was submitted to the WABA gateway successfully.

WABA Billing Reminder

📋 Important: WABA messages are billed differently by category. Service messages (user-initiated, within a 24-hour session window) are charged per session. All other categories — Marketing, Utility, and Authentication — are charged per message. Refer to the WABA API Documentation for full billing details.

Response & Error Codes

General Errors

CodeDescription
0 / OKRequest successful
-1The system is busy — retry after a short delay
1000Unknown error
1001Authentication failed — check username and password
1002Account suspended or expired
1003IP address not allowed
1004Insufficient credits
1008Missing required parameter

WABA-Specific Errors

CodeDescription
50500Invalid destination phone number
70500Invalid WABA account
70501Invalid WABA API key
70502Insufficient WABA credits

Application & Session Errors

CodeDescription
40001Invalid AppSecret or AccessToken
40008Invalid message type
41000Required parameter not specified
42001Access token expired
45001API call limit exceeded
45010Reply time limit exceeded — outside the 24-hour session window
47001JSON parsing error — check request body format
48001Not authorized to call this API

Template Errors

CodeDescription
60005templateCode parameter not specified
60006Template code does not exist
60012Invalid parameter format
70001Scenario sending policy not configured
📞 Need Help? Email: [email protected]  |  Toll Free: 1800 87 7061  |  KL: +603 2780 3880

Full API reference: WABA API Documentation →

📱 SMS Coverage — 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
Quick Links
Products
Pricing
Support