ClickSend icon

ClickSend

Consume ClickSend API

Overview

The Upload Media File operation of the ClickSend node allows you to upload a binary media file (such as an image, document, or audio) to the ClickSend platform. This is particularly useful when you need to send media via ClickSend's services (e.g., fax, MMS, CSV import, post, or postcard). The node can also convert the uploaded file to be compatible with the selected service type.

Common scenarios:

  • Sending an image as an MMS message.
  • Uploading a PDF for fax transmission.
  • Importing a CSV file for bulk messaging.
  • Preparing a file for postal mail or postcards.

Practical example:
You have a workflow where you receive a PDF invoice and want to fax it using ClickSend. You use this node to upload and convert the file for fax compatibility before sending.

Properties

Name Type Meaning
Convert to Type options Specifies the target service type for which the file should be converted (fax, mms, csv, etc.)
Input Data Field Name string The name of the input field containing the binary file data to be processed

Output

  • The node outputs a JSON object containing information about the uploaded file, such as its URL, ID, and any conversion details provided by ClickSend.
  • If the upload is successful, expect fields like file_url, file_id, and possibly metadata about the conversion.
  • Binary output: If the node supports returning binary data, it would represent the processed file, but typically the output is a JSON reference to the uploaded file on ClickSend.

Dependencies

  • External Service: Requires access to the ClickSend API.
  • API Key: You must configure valid ClickSend API credentials in n8n under the credential type clickSendApi.

Troubleshooting

  • Missing Credentials:
    Error: "No credentials found for clickSendApi."
    Resolution: Ensure you have set up and selected the correct ClickSend API credentials in your n8n instance.

  • Invalid Binary Property Name:
    Error: "Input Data Field Name not found in incoming data."
    Resolution: Make sure the specified field exists and contains valid binary data.

  • Unsupported File Type or Conversion:
    Error: "File type not supported for selected conversion."
    Resolution: Check that the file format matches the requirements for the chosen conversion type (e.g., only images for MMS).

  • API Errors:
    Error: Messages from ClickSend such as "Unauthorized" or "Bad Request."
    Resolution: Verify your API key and ensure all required parameters are correctly set.

Links and References

Discussion