📧 How to Test iSMS Email API Using Postman
Step-by-step guide to sending emails via the iSMS Email Sending API using Postman — POST request with x-www-form-urlencoded body.
Before You Start
Make sure you have the following ready:
- An active iSMS email service account — contact us to apply
- Your iSMS Username and Password
- A verified sender email address (accountName) configured in your account
- Postman installed — download free at postman.com
API Endpoint & Parameters
The iSMS Email API uses a POST request with x-www-form-urlencoded body. Endpoint:
https://smtpapi.vocotext.com/isms_send_email_smtp_api.php
| Parameter | Type | Description | Required |
|---|
| un | string | Your iSMS username | ✅ Yes |
| pwd | string | Your iSMS password | ✅ Yes |
| toEmail | string | Recipient's email address | ✅ Yes |
| subject | string | Subject of the email | ✅ Yes |
| body | string | Body content of the email (HTML supported) | ✅ Yes |
| accountName | string | Your verified sender email address to send from | ✅ Yes |
| fromAlias | string | Display name of the sender | ✅ Yes |
| agreedterm | string | Must be set to YES | ✅ Yes |
| attachment | file | Optional file attachment | ❌ Optional |
Step-by-Step: Send Email via Postman
1
Create a New Request — Set Method to POST
Open Postman. Click "New" → "HTTP Request". Set the method to POST.
Enter the endpoint URL:
https://smtpapi.vocotext.com/isms_send_email_smtp_api.php
2
Set Body → x-www-form-urlencoded
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 |
| toEmail | recipient@example.com |
| subject | Hello from iSMS Email API |
| body | <h1>Hello!</h1><p>This is a test email.</p> |
| accountName | sender@yourdomain.com |
| fromAlias | Your Company Name |
| agreedterm | YES |
📎 File attachment: x-www-form-urlencoded does not support file uploads. To send an email with an attachment, use form-data body type instead and set the attachment field type to "File".
3
Click Send and Check the Response
Click "Send". A successful response will be returned from the server confirming the email was accepted.
✅ Success — your email was accepted by the sending server. Delivery to the recipient's inbox depends on their mail server and spam filters.
PHP Code Example
<?php
$url = 'https://smtpapi.vocotext.com/isms_send_email_smtp_api.php';
$postData = [
'un' => 'myusername',
'pwd' => 'mypassword',
'toEmail' => 'recipient@example.com',
'subject' => 'Hello from iSMS Email API',
'body' => '<h1>Hello!</h1><p>This is a test email.</p>',
'accountName' => 'sender@yourdomain.com',
'fromAlias' => 'Your Company Name',
'agreedterm' => 'YES'
];
// Optional: add file attachment
// $postData['attachment'] = new CURLFile('/path/to/file.pdf', 'application/pdf', 'file.pdf');
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
📋 Note: The
accountName must be a verified sender email address in your iSMS email account. Using an unverified address will result in an error. Refer to the
Email API Documentation for full details.