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 faxes, among other message types. Specifically for the Send Fax operation, it allows users to send a fax by specifying sender and recipient numbers along with a URL pointing to the document/image to fax. This is useful in scenarios where automated faxing is required, such as sending contracts, invoices, or official documents directly from workflows without manual intervention.

Practical examples:

  • Automatically faxing signed contracts stored on cloud storage.
  • Sending invoices as faxes to clients who prefer fax communication.
  • Dispatching marketing materials or legal notices via fax triggered by CRM events.

Properties

Name Meaning
Sender Name / From Field The sender's fax 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 fax number. Can be local or international format. For international faxes, use the full international format (e.g., +61411111111).
Image URL The URL of the image or GIF file to send as the fax content.
Schedule Optional date and time to schedule when the fax should be sent.

Output

The output JSON contains the response from the ClickSend API after attempting to send the fax. It includes details about the request status, any errors, and metadata returned by ClickSend.

Example structure (simplified):

{
  "data": {
    "messages": [
      {
        "to": "+61411111111",
        "from": "+6144444444",
        "status": "queued",
        "message_id": "abc123"
      }
    ],
    "total": 1
  }
}

No binary data is output by this node.

Dependencies

  • Requires an active ClickSend account and an API key credential configured in n8n for authentication.
  • The node uses the ClickSend REST API endpoint https://rest.clicksend.com/v3/fax/send.
  • The user must provide valid URLs accessible by ClickSend servers for the fax content.

Troubleshooting

  • Invalid or missing sender number: If the sender number is not a valid dedicated ClickSend number or left blank incorrectly, the fax may fail. Ensure you have purchased a dedicated number or leave blank to use shared numbers.
  • Incorrect recipient number format: The recipient number must be in correct local or international format. International numbers require the "+" prefix and country code.
  • Invalid or inaccessible URL: The fax content URL must be publicly accessible by ClickSend. Private or restricted URLs will cause failures.
  • API authentication errors: Ensure the API key credential is correctly set up and has permissions to send faxes.
  • Scheduling issues: If scheduling a fax, ensure the date/time is valid and in the future.

Common error messages:

  • "Unauthorized": Check API credentials.
  • "Invalid phone number": Verify the 'to' and 'from' fields.
  • "File URL not accessible": Confirm the URL is reachable by ClickSend.

Links and References

Discussion