Overview
This node integrates with the Taximail API to send SMS messages, including standard SMS and OTP (One-Time Password) SMS. It supports sending SMS either by using a predefined template or custom text content. The node is useful for automating SMS notifications, alerts, marketing messages, or OTP verification workflows in applications.
For the Send SMS operation specifically, it allows sending transactional SMS messages to recipients by specifying their phone number and either an existing SMS template key or a custom SMS text message. This is beneficial when you want to send quick, customizable SMS notifications without managing your own SMS infrastructure.
Practical examples:
- Sending appointment reminders or delivery notifications to customers.
- Dispatching promotional SMS campaigns using predefined templates.
- Sending alerts or updates that require immediate attention via SMS.
Properties
| Name | Meaning |
|---|---|
| To Phone (MSISDN) | Recipient phone number including country code (e.g., 66812345678). Required for sending SMS. |
| SMS Template Key | Optional key of an existing SMS template to use instead of custom text. |
| SMS Text | Custom SMS message text to send if no template key is provided. Keep under 160 characters. |
Output
The node outputs a JSON object containing the response from the Taximail API after attempting to send the SMS. The output includes:
operation: The string"sms"indicating the performed operation.message_id: A unique identifier generated for the sent message, which can be saved for later status checks.- Additional fields returned by the Taximail API related to the SMS sending result.
note: A message advising to save themessage_idfor checking delivery status later.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Taximail API.
- The node makes HTTP requests to the Taximail API endpoints:
- Base URL:
https://api.taximail.com/v2 - SMS endpoint:
/sms
- Base URL:
- The user must configure the node with valid credentials for the Taximail service.
Troubleshooting
- Missing or invalid phone number: Ensure the "To Phone (MSISDN)" property is set correctly with the full international format.
- Template key issues: If using a template key, verify that the key exists and is active in the Taximail account.
- Message length: When not using a template, keep the SMS text under 160 characters to avoid truncation or additional charges.
- API errors: Errors from the Taximail API will be surfaced as node operation errors. Check the error message for details such as authentication failure or invalid parameters.
- Network issues: Ensure the n8n instance has internet access to reach the Taximail API endpoints.
Links and References
- Taximail Official Website
- Taximail API Documentation (for detailed API usage and template management)