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 physical letters via postal mail. It allows users to specify a letter document URL and detailed recipient address information, then sends the letter through ClickSend's printing and mailing service. This is useful for automating sending official documents, invoices, marketing materials, or personal correspondence without manual printing and postage.

Typical use cases include:

  • Automatically sending signed contracts or agreements stored in cloud storage.
  • Mailing invoices or statements to customers.
  • Sending personalized marketing letters or postcards.
  • Automating bulk mail campaigns with dynamic recipient data.

Properties

Name Meaning
Letter URL The URL of the letter document you want to send (e.g., a Google Docs or PDF link).
Recipient Name The full name of the person receiving the letter.
Address Line 1 First line of the recipient's postal address (street address).
Address Line 2 Optional second line of the recipient's postal address (apartment, suite, etc.).
City The city of the recipient's address.
State The state or region of the recipient's address.
Postal Code The postal or ZIP code of the recipient's address.
Return Address Name or ID Select or specify the return address from your saved addresses in ClickSend. This is the sender's address printed on the letter.
Select Country Name or ID Select the country of the recipient's address from a dropdown list or specify an ID.
Letter Template Indicates if you are using ClickSend's letter template format ("Yes" or "No").
Colour Printing Choose whether the letter should be printed in color ("Yes") or black and white ("No").
Double-Sided Printing Choose whether the letter should be printed double-sided ("Yes") or single-sided ("No").
Priority Post Choose whether to send the letter via priority post ("Yes") or standard post ("No").

Output

The node outputs JSON data representing the response from the ClickSend API after attempting to send the letter. This typically includes details such as message IDs, status, and any errors returned by the API.

If the request fails and "Continue On Fail" is enabled, the output will contain an error message describing the failure.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the ClickSend API.
  • Needs network access to https://rest.clicksend.com endpoints.
  • The user must have configured return addresses and countries in their ClickSend account to select from.
  • The letter document must be accessible via a public URL.

Troubleshooting

  • Common issues:

    • Invalid or inaccessible letter URL: Ensure the URL points to a publicly accessible document.
    • Missing required address fields: All mandatory address fields must be filled correctly.
    • Incorrect return address ID: Must select a valid return address configured in ClickSend.
    • API authentication errors: Verify that the API key credential is valid and has necessary permissions.
    • Network connectivity problems: Confirm that n8n can reach ClickSend API endpoints.

  • Error messages:

    • "Unsupported resource or operation": Occurs if the node is misconfigured with unsupported resource/operation combinations.
    • API errors returned from ClickSend will be included in the output JSON; check these for specific causes like invalid parameters or quota limits.

Links and References

Discussion