click-send

name

click-send

description

A cloud-based messaging and communication service that enables businesses to send and receive SMS, email, voice, and chat messages globally through APIs, automation tools, and dashboards to engage customers, deliver notifications, and streamline multichannel communications. Read and write ClickSend data through One: contacts, subaccounts, emailcampaigns, mmscampaigns, postreturnaddresses, smscampaigns and more, 188 actions with real parameter documentation. Use whenever the user asks to look something up in ClickSend, create or update a record there, or build code against the ClickSend API.

ClickSend through One

A cloud-based messaging and communication service that enables businesses to send and receive SMS, email, voice, and chat messages globally through APIs, automation tools, and dashboards to engage customers, deliver notifications, and streamline multichannel communications.

One exposes ClickSend through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform click-send if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm ClickSend is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real ClickSend account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Contacts

Action	Method	Path	Action id
Get a Contact in a List	GET	/lists/{{LIST_ID}}/contacts/{{CONTACT_ID}}	conn_mod_def::GJxn6lFlZZI::ivtESyl5Qtmsye3qt14QUQ
List Contacts in a List	GET	/lists/{{LIST_ID}}/contacts	conn_mod_def::GJxn6UHJ8Z8::zClR_tgyRZCY5fMzfG3QWg
Copy a Contact to Another List	PUT	/lists/{{FROM_LIST_ID}}/contacts/{{CONTACT_ID}}/copy/{{TO_LIST_ID}}	conn_mod_def::GJxn7IlfC7U::5AfGvLKqS9S4hEaBOIoaJA
Create a New Contact in a List	POST	/lists/{{LIST_ID}}/contacts	conn_mod_def::GJxn6b0ttgY::kHKzBSM-QT-_aD5i2mTKBQ
Import Contacts to a List	POST	/lists/{{LIST_ID}}/import	conn_mod_def::GJxn75-8Ob8::KOqv6eENRsSiKrB4N1XE2Q
Remove Duplicate Contacts From a List	PUT	/lists/{{LIST_ID}}/remove-duplicates	conn_mod_def::GJxn7zAz6FM::7ONEw1u6SmGfNtgRucZ3bA
Transfer a Contact to Another List	PUT	/lists/{{FROM_LIST_ID}}/contacts/{{CONTACT_ID}}/transfer/{{TO_LIST_ID}}	conn_mod_def::GJxn7C_tB_w::g7Wfub3UShO9lCaRdvgRNQ

Subaccounts

Action	Method	Path	Action id
Get a Specific Subaccount	GET	/subaccounts/{{SUBACCOUNT_ID}}	conn_mod_def::GJxoK6VKo1s::hxodwCx1ROymbLhAOjHB3g
List Subaccounts	GET	/subaccounts	conn_mod_def::GJxoKtYFM_A::96o48rbnQgqgqvaI5XN9Fw
Create a New Subaccount	POST	/subaccounts	conn_mod_def::GJxoKzkVyaw::jaidXVq-ToK8J-n7F3wjeA
Delete a Subaccount	DELETE	/subaccounts/{{SUBACCOUNT_ID}}	conn_mod_def::GJxoLKPuEck::qCaOuPKKTdyAVJ26zllaGA
Regenerate a Subaccount's API Key	PUT	/subaccounts/{{SUBACCOUNT_ID}}/regen-api-key	conn_mod_def::GJxoLR3OTwM::fRmdn5qfRCSmSS2-07uZ0A
Update a Subaccount	PUT	/subaccounts/{{SUBACCOUNT_ID}}	conn_mod_def::GJxoLCtabV0::TO5jziUCTgGDKFjvR3RmgQ

EmailCampaigns

Action	Method	Path	Action id
Get an Email Campaign	GET	/email-campaigns/{{EMAIL_CAMPAIGN_ID}}	conn_mod_def::GJxn9gm67JE::xa0QTPctQ02VnDJJDWn43w
List Email Campaigns	GET	/email-campaigns	conn_mod_def::GJxn9Z85D6s::5toidx1IR2y4RBVB3sazhQ
Cancel an Email Campaign	PUT	/email-campaigns/{{EMAIL_CAMPAIGN_ID}}/cancel	conn_mod_def::GJxn9z3_PP8::E8RObQE9S2Kb8gdg6uMQ_A
Edit an Email Campaign	PUT	/email-campaigns/{{EMAIL_CAMPAIGN_ID}}	conn_mod_def::GJxn9l9F3O8::7bM1bpn_RtCBdhWIlZd4aA
Send an Email Campaign	POST	/email-campaigns/send	conn_mod_def::GJxn9s5egbE::_bCdkHJAR_K6YQEQ3qt1bw

MmsCampaigns

Action	Method	Path	Action id
Get an MMS Campaign	GET	/mms-campaigns/{{MMS_CAMPAIGN_ID}}	conn_mod_def::GJxoEJ_bOb8::mHYEwiL4SBWcsjq9YqMkXA
List MMS Campaigns	GET	/mms-campaigns	conn_mod_def::GJxoElhw688::hHq5UTcqRzmBX-RDXY230Q
Cancel an MMS Campaign	PUT	/mms-campaigns/{{MMS_CAMPAIGN_ID}}/cancel	conn_mod_def::GJxoEZBbdz4::tY2ybzuiSTa_qUiaTL6LtQ
Send an MMS Campaign	POST	/mms-campaigns/send	conn_mod_def::GJxoDznUzsA::6AKzu1yXSUyr4FQ1sF0eJA
Update an MMS Campaign	PUT	/mms-campaigns/{{MMS_CAMPAIGN_ID}}	conn_mod_def::GJxoER0Mxv8::GXtNoUxnQ6GEWuu98ohEsA

PostReturnAddresses

Action	Method	Path	Action id
Get a Specific Post Return Address	GET	/post/return-addresses/{{RETURN_ADDRESS_ID}}	conn_mod_def::GJxoGPglEck::paC_QPUmSM6RRVbzDSkKNg
List Post Return Addresses	GET	/post/return-addresses	conn_mod_def::GJxoGDTgfUQ::hAEtNC28T_-zGgZzEQ6lpg
Create a Post Return Address	POST	/post/return-addresses	conn_mod_def::GJxoGJHXF9g::sFf9sdCXQXWojx72SMSAhQ
Delete a Post Return Address	DELETE	/post/return-addresses/{{RETURN_ADDRESS_ID}}	conn_mod_def::GJxoGbzZ880::Cxbki9KRRkuQJr5KxZIOqg
Update a Post Return Address	PUT	/post/return-addresses/{{RETURN_ADDRESS_ID}}	conn_mod_def::GJxoGVfxsgo::QNx_yoySRoexjeZr8RfceA

SmsCampaigns

Action	Method	Path	Action id
Get an SMS Campaign	GET	/sms-campaigns/{{SMS_CAMPAIGN_ID}}	conn_mod_def::GJxoJU5bFuk::klDZ__7tTkKfvJ7gKERV3A
List SMS Campaigns	GET	/sms-campaigns	conn_mod_def::GJxoJq_G5l4::BE4fZq9LTfiApHPA43z5Dg
Cancel an SMS Campaign	PUT	/sms-campaigns/{{SMS_CAMPAIGN_ID}}/cancel	conn_mod_def::GJxoJkmZ57g::aRAEhbk8SxSkhiml0j6LxQ
Send an SMS Campaign	POST	/sms-campaigns/send	conn_mod_def::GJxoJCvXxf0::l2QoXdD_SCKN0sCteos_ag
Update an SMS Campaign	PUT	/sms-campaigns/{{SMS_CAMPAIGN_ID}}	conn_mod_def::GJxoJdB3TLE::feix8zlMQTCl6Nr3HWzo7g

EmailTemplates

Action	Method	Path	Action id
Get a Specific Email Template	GET	/email/templates/{{template_id}}	conn_mod_def::GJxoMNqxXpk::qUC4UQEjR1O2UUePR7TBow
List Email Templates	GET	/email/templates	conn_mod_def::GJxoMCRWB_0::Ga-_FvlqTM2_j21DRO10vw
Create an Email Template	POST	/email/templates	conn_mod_def::GJxoMHelbdE::zzBKZ30sSICZC0pzViHnfQ
Delete an Email Template	DELETE	/email/templates/{{TEMPLATE_ID}}	conn_mod_def::GJxoMa3LriE::wOUcinmBR0SEh2tIHLCkxg
Update an Email Template	PUT	/email/templates/{{TEMPLATE_ID}}	conn_mod_def::GJxoMU8pJZU::bFJ1o6h0QH-GUKVhTY6D2g

ContactLists

Action	Method	Path	Action id
Get a Specific Contact List	GET	/lists/{{LIST_ID}}	conn_mod_def::GJxn7dB4AaA::y8g1xgGUQQOl5TRMLNCGKw
List Contact Lists	GET	/lists	conn_mod_def::GJxn7N0A8oc::Uk1Yp8EpSqKxsNc1CCNEHA
Search Contact Lists	GET	/search/contacts-lists	conn_mod_def::GJxoHGwSVfM::uXe3FVAgQ36miTaQqR1-MA
Delete a Contact List	DELETE	/lists/{{list_id}}	conn_mod_def::GJxn7rRX8Uo::OnOUekaFQuS71rHVETw7QQ

FaxReceipts

Action	Method	Path	Action id
Get a Fax Receipt by Message ID	GET	/fax/receipts/{{MESSAGE_ID}}	conn_mod_def::GJxn_VvoDBw::srF0FTUmRmCuhVfXn1VB8Q
List Fax Delivery Receipts	GET	/fax/receipts	conn_mod_def::GJxn_IaAkWA::jGg1tHh0R0KzqEIgtbSCgA
Add a Fax Delivery Receipt	POST	/fax/receipts	conn_mod_def::GJxn_O4_Qt8::kiUk7p9uSnudKGPifOa3fg
Mark Fax Delivery Receipts as Read	PUT	/fax/receipts-read	conn_mod_def::GJxn_eb3Wqk::Ab-qNHi0RgCmA1B8T5RjAQ

SmsReceipts

Action	Method	Path	Action id
Get an SMS Delivery Receipt by Message ID	GET	/sms/receipts/{{MESSAGE_ID}}	conn_mod_def::GJxoI2QNiio::SRbrhBu0QUGOVkFyUHhKfQ
List SMS Delivery Receipts	GET	/sms/receipts	conn_mod_def::GJxoHg10WhQ::8sfiFqHWRN6ui9cPFTx8Sg
Add an SMS Delivery Receipt URL	POST	/sms/receipts	conn_mod_def::GJxoHm8s6JE::6erEFZBeTxOA2U2-y-_t4A
Mark SMS Delivery Receipts as Read	PUT	/sms/receipts-read	conn_mod_def::GJxoHucgCuE::JBwHgfRxSRisDwn7KAs1ww

InboundSms

Action	Method	Path	Action id
List Inbound SMS	GET	/sms/inbound	conn_mod_def::GJxoH0pYFzQ::1a1QsJNrQDmMqa8eo_lcbg
Create Inbound SMS	POST	/sms/inbound	conn_mod_def::GJxoH6TEFhc::KWyX5nivReSerd6wFkg64g
Mark an Inbound SMS as Read	PUT	/sms/inbound-read/{{MESSAGE_ID}}	conn_mod_def::GJxoIv64vag::YOibAoc9QnuZpNi9ffXRTA
Mark Inbound SMS as Read	PUT	/sms/inbound-read	conn_mod_def::GJxoIm3xRzk::QV0T8OrzRl2h9mwPJ1grjg

SmsTemplates

Action	Method	Path	Action id
List SMS Templates	GET	/sms/templates	conn_mod_def::GJxoIMEVe9E::9F8L08b5QQqsRRiC3ugaeQ
Create an SMS Template	POST	/sms/templates	conn_mod_def::GJxoIQ9tByQ::TZdFA3EFQeGkWR0hbYfv5g
Delete an SMS Template	DELETE	/sms/templates/{{TEMPLATE_ID}}	conn_mod_def::GJxoIfhj5Lw::Lkmmxiu1Te2zkDb1fZNmqQ
Update an SMS Template	PUT	/sms/templates/{{TEMPLATE_ID}}	conn_mod_def::GJxoIXPvLs8::9WlQx7BgQD2GBAqPEL8OKg

EmailDeliveryReceiptAutomationRule

Action	Method	Path	Action id
Get an Email Delivery Receipt Automation Rule	GET	/automations/email/receipts/{{RECEIPT_RULE_ID}}	conn_mod_def::GJxn8hmhPfk::FwOPc_cNSLWWs0V2Dw8I9Q
Delete an Email Delivery Receipt Automation Rule	DELETE	/automations/email/receipts/{{RECEIPT_RULE_ID}}	conn_mod_def::GJxn8uRU-tU::uWZyZDFVScWkkkVIZ_L7XA
Update an Email Delivery Receipt Automation Rule	PUT	/automations/email/receipts/{{RECEIPT_RULE_ID}}	conn_mod_def::GJxn8nVIS14::h4jB9yl7SqCWjSYTMSaQqA

AllowedEmailAddresses

Action	Method	Path	Action id
Get a Specific Allowed Email Address	GET	/email/addresses/{{email_address_id}}	conn_mod_def::GJxn9OmlSu4::R9Mc8r8jRsKIvh5sKZBriA
Create an Allowed Email Address	POST	/email/addresses	conn_mod_def::GJxn877Z9Sw::cbTbf9m8RAq_BJ1cCDZBXQ
Delete a Specific Allowed Email Address	DELETE	/email/addresses/{{EMAIL_ADDRESS_ID}}	conn_mod_def::GJxn9T_GoSk::3j4M0n39QBycN98fGwfcug

UserCountries

Action	Method	Path	Action id
Get User Countries for Global Sending	GET	/user-countries	conn_mod_def::GJxoAksrV7c::KhCl6LnrTKqLXT-yzpv3Gg
Agree to User Country Rules and Regulations	POST	/user-countries/agree	conn_mod_def::GJxoAzaT6vQ::--35KXB4Q5O0-QGMnRNlMg
Select Countries for Global Sending	POST	/user-countries	conn_mod_def::GJxoArPngL4::LEfGT9LMTgC4hhJgA-56wQ

InboundSmsAutomationRule

Action	Method	Path	Action id
Create an Inbound SMS Automation Rule	POST	/automations/sms/inbound	conn_mod_def::GJxoB1Dm2BA::gRI5N3LAQzGlS7LqdzS0Mw
Delete an Inbound SMS Automation Rule	DELETE	/automations/sms/inbound/{{INBOUND_RULE_ID}}	conn_mod_def::GJxoCObk3ys::yNNz6naCQOyNOHPbGm9BDw
Update an Inbound SMS Automation Rule	PUT	/automations/sms/inbound/{{INBOUND_RULE_ID}}	conn_mod_def::GJxoCE_nsks::V-TqjclaQiyU2a7Jkenrqw

DedicatedNumbers

Action	Method	Path	Action id
Get Dedicated Numbers by Country	GET	/numbers/search/{{country}}	conn_mod_def::GJxoFCW2l9Q::vyfdoAVnR4CuhuvCXnoJ3w
List Available Dedicated Numbers	GET	/numbers	conn_mod_def::GJxoEvbg2ZQ::fNnaXN48QLacaiTCX25jKw
Buy a Dedicated Number	POST	/numbers/buy/{{DEDICATED_NUMBER}}	conn_mod_def::GJxoE6S6OkM::tFu6o2gkQM-qeJBtrMCyTQ

SmsDeliveryReceiptAutomationRule

Action	Method	Path	Action id
Get an SMS Delivery Receipt Automation Rule	GET	/automations/sms/receipts/{{RECEIPT_RULE_ID}}	conn_mod_def::GJxoKEj8mJo::Ilv6AmB8QtaL6R35Cac5Yw
Delete an SMS Delivery Receipt Automation Rule	DELETE	/automations/sms/receipts/{{RECEIPT_RULE_ID}}	conn_mod_def::GJxoKT0Sup4::fokbox37SginXhZQD3KZMQ
Update an SMS Delivery Receipt Automation Rule	PUT	/automations/sms/receipts/{{RECEIPT_RULE_ID}}	conn_mod_def::GJxoKMHQgac::iUP0cJ9bTn6c11f2IOkyxQ

VoiceMessages

Action	Method	Path	Action id
Cancel a Voice Message by Message ID	PUT	/voice/{{MESSAGE_ID}}/cancel	conn_mod_def::GJxoNC6K9e4::aSwvQ0fmTwqKbPSskasQ2Q
Cancel All Voice Messages	PUT	/voice/cancel-all	conn_mod_def::GJxoNH8W37g::Oz2xc42ZQGCzX-UEnFratQ
Send Voice Message(s)	POST	/voice/send	conn_mod_def::GJxoMgH1Ccs::dr6yeqmcSs6IuKo1lknt8w

VoiceReceipts

Action	Method	Path	Action id
List Voice Delivery Receipts	GET	/voice/receipts	conn_mod_def::GJxoMxAxyHc::3C9ftPNrQOi6dMQJOL7Ntw
Add a Voice Delivery Receipt	POST	/voice/receipts	conn_mod_def::GJxoM2ZV5v0::sALGZVqZS429vTfegtaHGQ
Mark Voice Delivery Receipts as Read	PUT	/voice/receipts-read	conn_mod_def::GJxoM9Q0hlw::9lilONxyTMqMvbMPha_40g

Account

Action	Method	Path	Action id
Get Account Information	GET	/account	conn_mod_def::GJxn4msq_UI::o78GoZa8Q76nwmbhF9D3Xg
Create an Account	POST	/account	conn_mod_def::GJxn4tL5rQQ::4vqFTyPsTVeRwBKCN-0JJA

RechargeTransactions

Action	Method	Path	Action id
Get a Specific Recharge Transaction	GET	/recharge/transactions/{{TRANSACTION_ID}}	conn_mod_def::GJxn6LhZIDs::NRnXXGd7RHGr9zaZ8fGnxg
List Recharge Transactions	GET	/recharge/transactions	conn_mod_def::GJxn6EwzBEo::5XvRh5zaQLSXgOfUi1aMpw

ContactList

Action	Method	Path	Action id
Create a Contact List	POST	/lists	conn_mod_def::GJxn7VAuayY::_PAj7QcYRbOAVcOj4JxGkQ
Update a Contact List	PUT	/lists/{{LIST_ID}}	conn_mod_def::GJxn7lG84ww::I_88osGPSoiM6K2-Jga0tw

Countries

Action	Method	Path	Action id
List Countries	GET	/country-list	conn_mod_def::GJxoA6GpHXg::4B7-h6dlR1i8lDTGnsgEkQ
List Countries (Country Codes)	GET	/countries	conn_mod_def::GJxn7_nxgLA::0zv2UKEjRletcQ9FA6W2qw

This lists 90 of 188 actions. For anything not here, call search_one_platform_actions with platform click-send. The full catalog is at https://www.withone.ai/knowledge/click-send.

When a call fails

The error comes from ClickSend, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/click-send

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.