ClickSend icon

ClickSend

Consume Clicksend API
Join our community

Actions7

  • Send Fax Actions
  • Send Letter Actions
  • Send MMS. Actions
  • Send Postcard Actions
  • Send SMS Actions
  • Send SMS to a Contact List Actions
  • Send Voice Actions

Overview

This node integrates with the ClickSend API to send SMS messages. Specifically, for the "Send SMS" resource and "Send" operation, it allows users to send text messages to individual phone numbers. This is useful in scenarios such as sending notifications, alerts, reminders, or marketing messages directly from an automated workflow.

Practical examples include:

  • Sending appointment reminders to customers.
  • Notifying users about order status updates.
  • Broadcasting promotional messages to a contact list (though that is a separate resource/operation).

Properties

Name Meaning
Sender Name / From Field Name or ID The sender identifier shown on the recipient's device. Choose from a list of dedicated numbers you own or specify an ID via expression. If left blank, a shared number may be used.
Recipient Number / To Field The phone number of the message recipient. Can be local or international format. For international recipients, use the full international format (e.g., +61411111111). This field is required.
Message Body The content of the SMS message. A standard SMS supports up to 160 characters.
Schedule Optional date and time to schedule when the message will be sent. If not set, the message is sent immediately.
Custom String An optional reference string (max 50 characters) to label or tag the message, e.g., campaign name, order ID, or test tag.

Output

The node outputs JSON data representing the response from the ClickSend API after attempting to send the SMS. This typically includes details about the message status, IDs, and any errors if they occurred.

No binary data output is produced by this node for the Send SMS operation.

Example output structure (simplified):

{
  "data": {
    "messages": [
      {
        "message_id": "string",
        "status": "string",
        "to": "+61411111111",
        "custom_string": "promo_campaign"
      }
    ]
  }
}

Dependencies

  • Requires an API key credential for authenticating with the ClickSend API.
  • The node uses the ClickSend REST API endpoint https://rest.clicksend.com/v3/sms/send.
  • No additional environment variables are needed beyond the API authentication setup.

Troubleshooting

  • Invalid phone number format: Ensure the recipient number is in the correct local or international format. International numbers must start with a plus sign (+) followed by country code.
  • Missing required fields: The "to" (recipient) and "message" fields are mandatory. Omitting these will cause errors.
  • API authentication errors: Verify that the API key credential is correctly configured and has permissions to send SMS.
  • Scheduling issues: If scheduling a message, ensure the date/time is valid and in the future.
  • Quota or limit exceeded: ClickSend accounts have limits; exceeding them will result in errors.
  • Error messages from API: The node surfaces error messages returned by ClickSend. Review those messages for specific causes.

Links and References

Discussion