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 without consuming credits

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:

• To: Phone number(s), comma-separated. International format, digits only (e.g., 96598765432).
• Message: SMS text. English: 160 chars/page. Arabic: 70 chars/page. Max 7 pages.
• Sender ID: Must be pre-approved on your kwtSMS account.
• Test Mode (optional): Send without delivering or consuming credits.

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:

• +96598765432 becomes 96598765432 (strip +)
• 0096598765432 becomes 96598765432 (strip 00)
• 965 9876 5432 becomes 96598765432 (strip spaces)
• Arabic/Hindi digits are converted to Latin automatically

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	Must wait 15 seconds before sending to the same number again.

Compatibility

• n8n version 1.0 or later
• Node.js 18 or later

Resources

• kwtSMS Website
• kwtSMS Support
• n8n Community Nodes Documentation

License

MIT