Description
n8n-nodes-kwtsms
n8n community node for the kwtSMS SMS gateway. Send SMS messages, check balance, validate numbers, and manage sender IDs directly from your n8n workflows.
kwtSMS is a Kuwait-based SMS gateway with coverage across 220+ countries, pay-as-you-go pricing, and built-in test mode. It supports both English and Arabic messages with transactional sender IDs that bypass DND for OTP delivery.
Features
- Send SMS: Single or bulk (auto-batches 200+ recipients with delays and retry logic)
- Check Balance: Query current account credit balance
- List Sender IDs: Retrieve approved sender IDs on your account
- Get Coverage: List active country prefixes
- Validate Numbers: Verify phone number format and routability before sending
- Phone Normalization: Automatically strips prefixes, converts Arabic digits, removes duplicates
- Message Cleaning: Strips emoji, hidden characters, and HTML tags before sending
- Pre-send Safety: Checks balance and coverage before hitting the API
- Test Mode: Send with test=1 to validate integration. Test messages are queued but not delivered. Their credits are held until you delete them from the Sending Queue in your kwtsms.com account.
Installation
Community Node (Recommended)
1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Select Install a community node
4. Enter n8n-nodes-kwtsms
5. Agree to the risks and click Install
Manual Installation
cd ~/.n8n/nodes
npm install n8n-nodes-kwtsms
Restart n8n after installation.
Credentials
You need a kwtSMS API account:
1. Sign up or log in at kwtsms.com
2. Navigate to your API settings to find your API username and API password
3. In n8n, create a new kwtSMS API credential
4. Enter your username, password, and default sender ID
5. Click Test to verify your credentials
> Note: The API username/password are separate from your account login credentials. Find them in your kwtSMS dashboard under API settings.
Operations
SMS
| Operation | Description |
|———–|————-|
| Send | Send an SMS to one or more recipients. Supports bulk sending with auto-batching, phone normalization, message cleaning, balance/coverage pre-checks, and duplicate removal. |
Parameters:
965XXXXXXXX). – Sender ID: Must be pre-approved on your kwtSMS account. Empty uses the default from the credentials.
– Test Mode: On by default. Messages are queued but not delivered. Credits are held until you delete them from the Sending Queue. Turn it off for real sends.
Workflows created before 0.3.0 keep the old fields (node version 1) and behave exactly as before.
Account
| Operation | Description |
|———–|————-|
| Get Balance | Returns available credits and total purchased credits. |
| Get Coverage | Returns array of active country prefixes on your account. |
Sender
| Operation | Description |
|———–|————-|
| List | Returns all available sender IDs on your account. |
Validation
| Operation | Description |
|———–|————-|
| Validate Numbers | Validates phone numbers and returns OK (valid), ER (format error), and NR (no route) arrays. Numbers are normalized automatically before validation. |
Phone Number Format
Numbers are automatically normalized before any API call:
+965XXXXXXXX becomes 965XXXXXXXX (strip +)00965XXXXXXXX becomes 965XXXXXXXX (strip 00)+965 XXXX XXXX becomes 965XXXXXXXX (strip + and spaces)Error Handling
The node maps all 33 kwtSMS error codes to user-friendly messages. Common errors:
| Code | Description |
|——|————-|
| ERR003 | Authentication failed. Check your API username and password. |
| ERR006 | No valid phone numbers provided. |
| ERR010 | Account balance is zero. |
| ERR013 | Send queue is full. The node retries automatically with backoff. |
| ERR028 | Sent to the same number too soon. Duplicate SMS protection is opt-in per account (API settings); when on, the whole request is rejected and nothing is charged if any number was sent the same message within the account’s window (10 seconds by default). |
