ClickSend connector for AI agents

Tools your messaging agent reaches for on ClickSend, scoped per user.

CALL ANY TOOL

84 tools for SMS messaging in ClickSend: send SMS, MMS, voice calls, faxes, letters, and postcards, run SMS campaigns, manage contact lists and templates, price a send before it goes, and read receipts and history.

clicksend_account_get

Get account

Get the authenticated ClickSend account's details. Returns user_id, username, name, email, country, currency, balance and account settings. Use clicksend_account_get to check credit balance or confirm the connection works. Use clicksend_account_usage_get for monthly usage.

Parameters

Name

Type

Required

Description

—

No parameters required

clicksend_contact_copy

Copy contact

clicksend_contact_create

Create contact

clicksend_contact_delete

Delete contact

clicksend_contact_get

Get contact

clicksend_contact_update

Update contact

Update a contact's details in a contact list. Only the fields you provide are sent. Returns the updated contact. Use clicksend_contact_update to edit a contact. Use clicksend_contact_transfer to move it to another list.

Parameters

Name

Type

Required

Description

contact_id

integer

Required

ID of the contact. Get it from the contact_id field of clicksend_list_contacts_list or clicksend_contacts_lists_search. Example: 1503921.

list_id

integer

Required

ID of the contact list. Get it from the list_id field of clicksend_lists_list or clicksend_contacts_lists_search. Example: 428.

address_city

string

Optional

Contact's city. Example: "Perth".

address_country

string

Optional

Contact's two-letter ISO country code. Example: "AU".

address_line_1

string

Optional

First line of the contact's street address. Example: "1 Test Street".

address_line_2

string

Optional

Second line of the contact's street address. Example: "Unit 4".

address_postal_code

string

Optional

Contact's postal or ZIP code. Example: "6000".

address_state

string

Optional

Contact's state or region. Example: "WA".

custom_1

string

Optional

Custom field 1, usable as a merge field in messages. Example: "VIP".

custom_2

string

Optional

Custom field 2, usable as a merge field in messages. Example: "Gold tier".

custom_3

string

Optional

Custom field 3, usable as a merge field in messages. Example: "Renewal 2026-03".

custom_4

string

Optional

Custom field 4, usable as a merge field in messages. Example: "Account 88231".

string

Optional

Contact's email address. At least one of phone_number, email or fax_number is needed. Example: "jane@example.com".

fax_number

string

Optional

Contact's fax number in E.164 format. Example: "+61261111111".

first_name

string

Optional

Contact's first name. Example: "Jane".

last_name

string

Optional

Contact's last name. Example: "Doe".

organization_name

string

Optional

Contact's organization or company name. Example: "Acme Pty Ltd".

phone_number

string

Optional

Contact's phone number in E.164 format. At least one of phone_number, email or fax_number is needed. Example: "+61411111111".

clicksend_contacts_lists_search

Search contacts lists

clicksend_countries_list

List countries

clicksend_email_address_verification_send

Send email address verification

clicksend_email_address_verify

Verify email address

clicksend_email_history_list

List email history

clicksend_letter_cancel

Cancel letter

clicksend_letter_history_list

List letter history

clicksend_letter_price_calculate

Letter price calculate

Calculate what posting a letter would cost without sending it. Returns the total price. Use clicksend_letter_price_calculate before clicksend_letter_send.

Parameters

Name

Type

Required

Description

address_city

string

Required

City of the recipient address. Example: "Perth".

address_country

string

Required

Two-letter ISO country code of the recipient address. Example: "AU".

address_line_1

string

Required

First line of the recipient street address. Example: "1 Test Street".

address_name

string

Required

Name on the recipient address, such as a person or company. Example: "John Smith".

address_postal_code

string

Required

Postal or ZIP code of the recipient address. Example: "6000".

file_url

string

Required

Public URL of the PDF letter to print and post. Convert docx or doc first with clicksend_upload_create (convert post). Example: "https://example.com/letter.pdf".

return_address_id

integer

Required

ID of the return address printed on the item, from clicksend_return_addresses_list or clicksend_return_address_create. Example: 1.

address_line_2

string

Optional

Second line of the recipient street address, such as a unit or suite. Example: "Unit 4".

address_state

string

Optional

State, province or region of the recipient address. Example: "WA".

colour

integer

Optional

Set to 1 to print in colour or 0 for black and white. Example: 0. One of: `0`, `1`.

custom_string

string

Optional

Your own reference for this message. ClickSend returns it with delivery receipts and replies so you can match them up. Example: "order-1042".

duplex

integer

Optional

Set to 1 to print double-sided or 0 for single-sided. Example: 1. One of: `0`, `1`.

priority_post

integer

Optional

Set to 1 for priority post or 0 for standard. Example: 0. One of: `0`, `1`.

schedule

integer

Optional

When to send the item, as a Unix timestamp in seconds. Leave empty to send immediately. Example: 1767225600.

source

string

Optional

Free-text label for the application sending the request, used by ClickSend to tag where messages came from. Example: "scalekit-agent".

template_used

integer

Optional

Set to 1 if the PDF uses ClickSend's letter template (address window layout), otherwise 0. Example: 1. One of: `0`, `1`.

clicksend_letter_send

Send letter

Print a PDF letter and post it to one postal address, now or at a scheduled time. Returns the queued letter with its message_id, status and price. Use clicksend_letter_send to mail a letter. Use clicksend_letter_price_calculate to quote the cost and clicksend_postcard_send for postcards. Needs a return address from clicksend_return_addresses_list.

Parameters

Name

Type

Required

Description

address_city

string

Required

City of the recipient address. Example: "Perth".

address_country

string

Required

Two-letter ISO country code of the recipient address. Example: "AU".

address_line_1

string

Required

First line of the recipient street address. Example: "1 Test Street".

address_name

string

Required

Name on the recipient address, such as a person or company. Example: "John Smith".

address_postal_code

string

Required

Postal or ZIP code of the recipient address. Example: "6000".

file_url

string

Required

Public URL of the PDF letter to print and post. Convert docx or doc first with clicksend_upload_create (convert post). Example: "https://example.com/letter.pdf".

return_address_id

integer

Required

ID of the return address printed on the item, from clicksend_return_addresses_list or clicksend_return_address_create. Example: 1.

address_line_2

string

Optional

Second line of the recipient street address, such as a unit or suite. Example: "Unit 4".

address_state

string

Optional

State, province or region of the recipient address. Example: "WA".

colour

integer

Optional

Set to 1 to print in colour or 0 for black and white. Example: 0. One of: `0`, `1`.

custom_string

string

Optional

Your own reference for this message. ClickSend returns it with delivery receipts and replies so you can match them up. Example: "order-1042".

duplex

integer

Optional

Set to 1 to print double-sided or 0 for single-sided. Example: 1. One of: `0`, `1`.

priority_post

integer

Optional

Set to 1 for priority post or 0 for standard. Example: 0. One of: `0`, `1`.

schedule

integer

Optional

When to send the item, as a Unix timestamp in seconds. Leave empty to send immediately. Example: 1767225600.

source

string

Optional

Free-text label for the application sending the request, used by ClickSend to tag where messages came from. Example: "scalekit-agent".

template_used

integer

Optional

Set to 1 if the PDF uses ClickSend's letter template (address window layout), otherwise 0. Example: 1. One of: `0`, `1`.

clicksend_list_create

Create list

clicksend_list_opted_out_remove

Remove list opted out

clicksend_mms_history_list

List mms history

clicksend_postcard_history_list

List postcard history

clicksend_return_address_create

Create return address

clicksend_return_address_get

Get return address

clicksend_sms_campaign_cancel

Cancel sms campaign

clicksend_sms_campaign_price_calculate

Sms campaign price calculate

clicksend_sms_campaign_send

Send sms campaign

clicksend_sms_history_list

List sms history

clicksend_sms_inbound_get

Get sms inbound

clicksend_sms_inbound_mark_all_read

Read sms inbound mark all

clicksend_sms_template_get

Get sms template

clicksend_sms_templates_list

List sms templates

clicksend_voice_history_list

List voice history

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// ClickSend tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["clicksend"], toolNames: [
    "clicksend_sms_price_calculate",
    "clicksend_sms_send",
    "clicksend_sms_receipt_get"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Text the order shipped notice to +14155550123 and confirm delivery" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["clicksend"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Text the order shipped notice to +14155550123 and confirm delivery" }],
  tools,
});

// Execute the tool call with the user's vaulted ClickSend API username and API key
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["clicksend"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Text the order shipped notice to +14155550123 and confirm delivery" }],
  tools,
});

// Tool call runs with the user's vaulted ClickSend API username and API key
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["clicksend"] }, pageSize: 100,
});

const agent = new Agent({
  name: "messaging_agent",
  model: "gemini-2.5-pro",
  instruction: "ClickSend tools scoped to this user",
  tools,
});

await agent.run("Text the order shipped notice to +14155550123 and confirm delivery");

Try these prompts

Copy any prompt into your agent. Each maps directly to a ClickSend tool. Click to copy, paste into your agent, done.

Messages

Copy the prompt

Copied

Text +14155550123: Your order has shipped and arrives Thursday.

Copy the prompt

Copied

Show the SMS replies we received today.

Copy the prompt

Copied

How much would a 2-part SMS to the VIP Customers list cost?

Campaigns and lists

Copy the prompt

Copied

Schedule an SMS campaign to the Spring Sale list for Monday at 10am.

Copy the prompt

Copied

Create a contact list called Webinar Attendees and import this CSV.

Copy the prompt

Copied

Remove every opted-out number from the Newsletter list.

Voice, fax, and post

Copy the prompt

Copied

Place a text-to-speech call to +14155550123 reminding them of tomorrow's 9am appointment.

Copy the prompt

Copied

Fax the signed contract PDF to +61290000000.

Copy the prompt

Copied

Post this invoice PDF as a letter to our Sydney client.

SEE HOW AUTH WORKS

Each user connects their own ClickSend API username and API key once, and Scalekit sends them with every call. Credentials stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

ClickSend

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

ClickSend

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

ClickSend

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

ClickSend

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other messaging and communication connectors.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

Support and Ops Teams

Support ticket automation agent

Fetches new Zendesk tickets, drafts a reply from Notion knowledge base articles, digests what it cannot answer to Slack, and archives the rest, acting as the support agent rather than a shared API key.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared ClickSend API key looks fine in a demo. In production every text and campaign looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared key
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

ClickSend today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access ClickSend as the user or through a shared API key?

As the user. Each user connects their own ClickSend API username and API key once, and Scalekit sends them with every call. Audit logs attribute every message and campaign to that user, not a shared service account.

Where are the ClickSend credentials stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate them, the user reconnects with a new API key. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in ClickSend?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example the history, receipt, and price tools without clicksend_sms_campaign_send or clicksend_list_delete, which deletes a list and its contacts. Scalekit also enforces scope checks before every API call.

What happens when ClickSend access is turned off?

Disable the connection in the Scalekit dashboard and the next tool call fails closed with a clear error. Other tenants are unaffected, and the change is logged.

Can the agent check what a send costs before it spends credit?

Yes. ClickSend has price tools for every channel, such as clicksend_sms_price_calculate and clicksend_letter_price_calculate, that return the price without sending. clicksend_account_get returns the account balance, so an agent can confirm the cost before it sends.