Overview
This node allows sending SMS messages via the Kudosity service. It is designed to facilitate communication by programmatically dispatching text messages to recipients using a specified sender number. Common scenarios include sending notifications, alerts, reminders, or marketing messages directly from an automated workflow.
For example, you could use this node to:
- Send appointment reminders to customers.
- Notify users about system status updates.
- Dispatch promotional offers or event invitations.
The node supports specifying the message content, sender number, recipient number, and additional optional fields such as message references and link tracking.
Properties
| Name | Meaning |
|---|---|
| Message | The text content of the SMS message to send (up to 5,000 characters). |
| Sender | The phone number used as the sender of the SMS. Options are dynamically loaded from the service's available numbers. |
| Recipient | The recipient's phone number in E.164 format (e.g., 61438333061). |
| Additional Fields | Optional extra parameters: |
| - Message Reference | A custom reference string for your system (max 500 characters). |
| - Track Links | Boolean flag to enable link tracking and shortening within the message. |
Output
The node outputs JSON data representing the response from the Kudosity SMS API after sending the message. This typically includes details such as message ID, status, timestamps, and any metadata returned by the service.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Kudosity SMS service.
- The node makes HTTP requests to the Kudosity API endpoints (
https://api.transmitmessage.comandhttps://api.transmitsms.com). - The "Sender" property options are dynamically fetched from the Kudosity API using Basic Authentication with the provided credentials.
Troubleshooting
- Authentication Errors: If the node fails to load sender options or send messages due to authentication issues, verify that the API key and password credentials are correctly configured and valid.
- Invalid Phone Numbers: Ensure recipient numbers are in correct E.164 format; otherwise, the API may reject the request.
- Message Length: Messages longer than 5,000 characters may be truncated or rejected.
- Network Issues: Connectivity problems can cause request failures; check network access to the Kudosity API endpoints.
- API Response Errors: The node will throw errors if the API returns error responses; review the error message for details and adjust inputs accordingly.
Links and References
- Kudosity SMS API Documentation (hypothetical link based on context)
- E.164 Phone Number Format
- n8n Documentation on Creating Custom Nodes