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 multimedia messages (MMS) among other communication types. Specifically, for the Send MMS operation, it allows users to send an MMS message containing an image or GIF along with a subject line and message body to a specified recipient phone number.

Common scenarios where this node is beneficial include:

  • Sending promotional images or GIFs to customers.
  • Delivering multimedia alerts or notifications.
  • Sharing visual content in marketing campaigns via MMS.

For example, a business could use this node to send a product image with a promotional message directly to customers' mobile phones.

Properties

Name Meaning
Sender Name/ From Field The sender's phone number. Use a dedicated ClickSend number you have purchased. If left blank, a free shared number will be used.
Recipient Number / To Field The recipient's phone number. Can be local or international format. For international recipients, the number must be in international format (e.g., +61411111111).
Image URL The URL of the image or GIF to send as part of the MMS message.
Message Body The text message content accompanying the MMS. Maximum 1500 characters allowed.
Subject Line The subject line of the MMS message.

Output

The node outputs a JSON object representing the response from the ClickSend API after attempting to send the MMS. This typically includes details about the message status, any errors, and metadata returned by the API.

No binary data output is produced by this operation.

Example structure of the output JSON might include fields such as:

{
  "data": {
    "messages": [
      {
        "message_id": "string",
        "status": "string",
        "to": "+61411111111",
        "from": "+6144444444",
        "body": "Your message here",
        "subject": "Your subject here"
      }
    ]
  }
}

Dependencies

  • Requires an active ClickSend account and an API key credential configured in n8n for authentication.
  • The node makes HTTP POST requests to the ClickSend API endpoint https://rest.clicksend.com/v3/mms/send.
  • The user must provide valid URLs for the media files (images or GIFs) accessible over the internet.

Troubleshooting

  • Invalid or missing recipient number: Ensure the "Recipient Number / To Field" is provided and formatted correctly, especially for international numbers.
  • Invalid media URL: The "Image URL" must be a publicly accessible URL pointing to a valid image or GIF file.
  • Authentication errors: Verify that the API key credential is correctly set up and has permissions to send MMS messages.
  • Message too long: The message body should not exceed 1500 characters; otherwise, the API may reject the request.
  • Unsupported resource or operation error: This occurs if the node is misconfigured with unsupported resource-operation combinations. Make sure to select "Send MMS" under the correct resource and operation.

If the node throws errors related to network connectivity or API limits, check your internet connection and ClickSend account usage quotas.

Links and References

Discussion