Overview
This node integrates with the Taximail API to send SMS messages, including standard SMS and OTP (One-Time Password) SMS. It supports sending custom text messages or using predefined SMS templates. The node is useful for automating SMS notifications, alerts, marketing messages, or OTP verification workflows in applications.
For example:
- Sending a promotional SMS to customers using a custom message or a saved template.
- Delivering OTP codes via SMS for user authentication or transaction verification.
- Automating SMS alerts triggered by events in other systems.
Properties
| Name | Meaning |
|---|---|
| To Phone (MSISDN) | Recipient phone number including country code (e.g., 66812345678). Required for SMS sending. |
| SMS Template Key | Optional key to use an existing SMS template instead of custom text (only for standard SMS). |
| SMS Text | Custom SMS message text (max 160 characters). Not needed if using a template. |
Output
The node outputs JSON data containing the response from the Taximail API for each sent SMS. The output includes:
operation: The type of operation performed (sms).message_id: A unique identifier generated for the message, which can be saved for later status checks.- Additional fields returned by the API such as delivery status or error messages.
- A note reminding to save the
message_idfor checking delivery status later.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for HTTP Basic Authentication to access the Taximail API.
- The node uses the Taximail REST API endpoints for transactional SMS sending.
- Network connectivity to
https://api.taximail.comis required.
Troubleshooting
- Missing or invalid phone number: Ensure the "To Phone (MSISDN)" field is filled correctly with the full international format.
- Template key issues: If using a template key, verify it exists and is valid in your Taximail account.
- API authentication errors: Confirm that the provided API credentials are correct and have necessary permissions.
- Message length: When not using a template, keep the SMS text under 160 characters to avoid truncation or rejection.
- Operation failures: Errors during sending will throw descriptive messages; check network connectivity and API limits.
Links and References
- Taximail API Documentation (for detailed API usage and templates)
- n8n Documentation on HTTP Basic Auth Credentials