Skip to main content

Integration Guide: n8n

This guide will walk you through the setup process and common use cases.

Overview

The ClickSend n8n Integration enables you to connect ClickSend's communication platform with your n8n workflows. n8n helps technical and non-technical users streamline and automate workflows — with ClickSend, you can send SMS, bulk SMS, and MMS, and trigger workflows from inbound SMS.


Key Features

  • Send SMS to individual numbers

  • Send SMS to contact lists (bulk messaging)

  • Send MMS with images

  • Receive inbound SMS via webhook triggers


Supported Channels

Channel

Status

Notes

SMS

✅ Active

Individual messaging

SMS to Contact List

✅ Active

Bulk messaging

MMS

✅ Active

Includes image attachments

Inbound SMS

✅ Active

Via webhook trigger



Prerequisites

Before you begin, ensure you have:

  • A ClickSend account (new accounts come with free test credits)

  • ClickSend API credentials (Username + API Key)

  • n8n cloud account

  • Available SMS credits

  • A ClickSend number (for inbound SMS)


Installation

How to use the ClickSend SMS n8n Community Node

  1. Log in to your n8n Cloud account.

  2. Create a new workflow from scratch.

  3. In the node panel on the left, search for ClickSend SMS in the trigger or action list, then drag the node into your workflow.

  4. Save and publish your workflow.


Setting Up Credentials in n8n

  1. Add a ClickSend node to your workflow

  2. Click Create New Credential

  3. Enter your credentials:

Field

Value

Username

Your ClickSend email

API Key

Your ClickSend API key (not your password)

4. Click Test — n8n will automatically validate the connection


Using the ClickSend Action Node

Available Actions

  • Send SMS (single recipient)

  • Send SMS to Contact List (bulk)

  • Send MMS

SMS Configuration

Field

Description

Action

SMS

Operation

Send

To

Recipient number in international format (e.g., +61411111111)

Message

SMS content (max 1,224 characters)

From

Optional sender ID — TFN, 10DLC, alpha tag, or validated own number

Example:

Parameter

Example

To

+61411111111

Message

Hello from n8n

From

(optional number or alpha tag)

MMS Configuration

Field

Description

Action

MMS

To

Recipient's international number

Message

Up to 1,500 characters

Image URL

Public .jpeg URL (one image only)

Subject

Required, up to 20 characters

From

Sender Name — must be TFN, 10DLC, or shared number (alpha tags not supported)

SMS to Contact List (Bulk)

Field

Description

Action

SMS

Operation

Send to Contact List

List

Select your ClickSend contact list

Message

SMS content

From

Optional sender ID


Receiving Inbound SMS via Webhook

To trigger n8n workflows from inbound SMS:

  1. In n8n:

    • Add a Webhook node to your workflow

    • Set the HTTP method to POST

    • Save and activate the workflow to generate the webhook Production URL (copy this)

  2. In ClickSend:

    • Log in to your ClickSend Dashboard

    • Go to SMS → Settings → Inbound SMS Rules

    • Click Add Rule

    • Select the ClickSend number you want to use for inbound messages

    • Paste your n8n webhook URL into the Forward URL field

    • Save the rule

  3. Test it:

    • Send an SMS to your ClickSend number

    • Check your n8n workflow execution log to confirm the webhook received the inbound message payload

    • Map the payload fields (e.g., sender number, message body) to the rest of your workflow as needed

Note: Inbound SMS is only supported on shared numbers, dedicated numbers, TFNs, and 10DLCs — not alpha tags.


Troubleshooting:

  • Check credentials: Use your ClickSend username and API key (not your password)

  • Check account credit: Top up here

  • Phone number format: Use international format (e.g., +1, +44)

  • Required fields:

    • SMS: Recipient number + message

    • MMS: Recipient number + message + image URL + subject

    • Inbound SMS: Valid ClickSend number + correctly configured webhook URL

  • Sender ID issues:

  • Webhook not firing:

    • Confirm the n8n workflow is active (not just saved)

    • Confirm the webhook URL in ClickSend matches the n8n Production URL, not the Test URL

    • Check that the inbound rule is pointed at the correct ClickSend number


FAQ

What package do I need to install?

n8n-nodes-clicksendsms, available via n8n's Community Nodes.

Can I send bulk SMS to a contact list?

Yes — select "Send SMS to Contact List" as the operation and choose your ClickSend contact list.

Can I send from an alpha tag?

Yes — max 11 characters, no spaces. Not supported in all countries, and not supported for MMS or inbound SMS.

Can I receive inbound SMS using alpha tags?

No. Inbound is only supported on shared numbers, dedicated numbers, TFNs, and 10DLCs.

How do I set an alpha tag as sender?

Enter your business name (11 characters or fewer) in the From field.

How do I set up inbound SMS triggers?

Add a Webhook node in n8n, activate your workflow, then add an Inbound SMS Rule in your ClickSend dashboard pointing to the n8n webhook URL.
See "Receiving Inbound SMS via Webhook" above.

My credentials won't validate — what should I check?
Confirm you're using your ClickSend account email and API key (not your

account password), and that your API key hasn't been regenerated since you added it to n8n.

Where can I find other ClickSend channels (Fax, Voice, Postcard, Letter)?

These are available through ClickSend's NPM package and may require additional configuration outside the native n8n node.

Did this answer your question?