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 various types of messages and documents, including postcards. Specifically, for the Send Postcard operation, it allows users to send a physical postcard by providing an image URL and recipient address details. This is useful in scenarios where businesses or individuals want to automate sending personalized postcards for marketing campaigns, event invitations, holiday greetings, or customer engagement.

For example, a marketing team could automatically send promotional postcards to customers after a purchase, or an event organizer could send invitation postcards to attendees without manual intervention.

Properties

Name Meaning
File URL The URL of the image you want to send as a postcard.
Recipient Name The name of the person receiving the postcard.
Address Line 1 First line of the recipient's address (e.g., street address).
Address Line 2 Second line of the recipient's address (optional).
City City of the recipient's address.
State State of the recipient's address.
Postal Code Postal code of the recipient's address.
Return Address Name or ID Select or specify the return address from a list or expression; this is the sender's address shown on the postcard.
Select Country Name or ID Select or specify the recipient's country from a list or expression.
Schedule Optional date and time when the postcard should be sent.

Output

The node outputs JSON data representing the response from the ClickSend API after attempting to send the postcard. This typically includes information about the success or failure of the request, message IDs, and any relevant metadata returned by the API.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "data": {
    "message_id": "string",
    "status": "queued",
    "recipient": "Recipient Name",
    ...
  }
}

Dependencies

  • Requires an API key credential for authenticating with the ClickSend API.
  • The node uses the ClickSend REST API endpoints to send postcards.
  • Network access to https://rest.clicksend.com is required.
  • The user must configure the API credentials securely within n8n.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Incorrect or inaccessible File URL may result in failure to send the postcard.
    • Missing required address fields will cause validation errors.
    • Scheduling with invalid date/time formats may cause errors.

  • Error messages:

    • Authentication errors: Check that the API key credential is correctly configured.
    • Validation errors from the API: Ensure all required fields are provided and valid.
    • Network errors: Verify network connectivity and endpoint accessibility.

  • To resolve errors, verify input parameters, ensure the File URL is publicly accessible, and confirm API credentials.

Links and References

Discussion