[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Schedule a ClickSend SMS campaign to a contact list

> Schedule a ClickSend SMS campaign to a contact list with the right sender and opt-out, from Claude Code or a script, after your OK.

Source: https://cotlet.dev/integrations/clicksend-api-mcp-server/schedule-sms-campaign

Your Monday promo goes to a whole contact list, and every week someone opens SMS campaigns, picks the list and the sender, adds the opt-out and sets the clock icon.

Cotlet does it in your own ClickSend account with list\_contact\_lists, create\_sms\_campaign and list\_sms\_campaigns, called by your AI agent, an n8n workflow or a script.

[Sign up free](https://cotlet.dev/app/signup?app=clicksend) [All ClickSend tools](https://cotlet.dev/integrations/clicksend-api-mcp-server.md)

Hosted · nothing to install or maintain

## Can ClickSend do this on its own?

ClickSend has a REST API with SMS campaigns, and its Zapier app has a Send SMS Campaign action (checked 23 Oct 2026). The official MCP server sends one SMS at a time and has no campaign tool, so an agent in Claude Code or Cursor cannot start a campaign through it.

## How you do it in ClickSend today

1. Log in to the ClickSend Dashboard and check your credit balance.
2. Go to SMS campaigns, click Add new campaign and type a nickname that only you see.
3. Pick the contact list in To and a sender in From, then write the message with placeholders such as \[First Name\], templates, emojis and shortened links.
4. For a marketing message add the opt-out that fits the sender: Reply STOP for a shared or dedicated number, an unsubscribe link for every sender type.
5. Pick Send Now, or set the time with the clock icon, then check the date and cost in the confirmation box and click Send.
6. A scheduled campaign waits under SMS > SMS Campaigns with the status Scheduled until it goes out, so the same clicks come back every week.

## How to schedule a ClickSend SMS campaign to a contact list

Prompt

```
Schedule an SMS campaign to Newsletter subscribers for Monday 9:00 from our dedicated number: "Black Friday starts Nov 27. Subscribers shop first." Add Reply STOP.
```

1. 01  
### Find the list  
list\_contact\_lists runs with the name from your prompt. If two lists match, for example "Newsletter" and "Newsletter old", the agent stops and asks which one, because a campaign goes to everyone on the list.
2. 02  
### Check the sender  
The agent compares the sender with the country of the list. Alpha tags cannot be used for US messaging and US messages need a registered dedicated number, so for a US list it refuses an alpha tag instead of swapping the sender for you.
3. 03  
### Choose the opt-out  
For a marketing text the agent sets opt\_out to match the sender: reply\_stop for a shared or dedicated number, unsubscribe\_link for an own number. A text with no opt-out is created only if you say it is not marketing.
4. 04  
### Set the time  
send\_at must be within 4 months and is read in the timezone set in your Dashboard, so the agent repeats the date and time back before the OK.
5. 05  
### Create after your OK  
create\_sms\_campaign waits for your OK by default. The confirmation shows the date, the recipient count and the cost, the same as the dashboard box before Send.
6. 06  
### Confirm it is queued  
list\_sms\_campaigns with status Scheduled shows the campaign with its send time, so you know it is waiting. Scheduled campaigns do not appear in SMS History.

### What you get back

Example data

```
Campaign "Black Friday teaser" scheduled for Mon 26 Oct, 09:00
List: Newsletter subscribers (1840 recipients)
Sender: +15550100188 (dedicated number), Reply STOP added
Cost shown at OK: 73.60 for 1 message part each
```

### Other ways to ask

- Every Thursday at 10:00, send the weekend offer to VIP customers from our alpha tag with an unsubscribe link.
- Draft the message for the Spring sale list in this chat and wait for my OK before you schedule anything.
- Cancel Monday's campaign and schedule it again for Friday at 9:00.

## What ClickSend allows, and what to know first

- A scheduled campaign goes to everyone on the list at send time, so contacts added after you scheduled it also receive it.
- ClickSend schedules SMS up to 4 months ahead; a later date means the message does not go out.
- An SMS campaign sends to one contact list of up to 20,000 recipients, while Quick SMS reaches up to 1,000 contacts.
- Reply STOP works automatically only in SMS campaigns; Quick SMS supports neither Reply STOP nor unsubscribe links.
- Link click tracking, with country, browser, device and OS, exists only for links sent in SMS campaigns.

create\_sms\_campaign asks for your OK by default. To run it weekly without you, switch confirmation off for that tool in your dashboard.

Sources: [ClickSend Help: SMS Campaign](https://help.clicksend.com/en/articles/42190-sms-campaign) · [ClickSend Help: Scheduling messages](https://help.clicksend.com/en/articles/42192-scheduling-messages) · [ClickSend Help: Managing opt-outs](https://help.clicksend.com/en/articles/43124-managing-opt-outs) · [ClickSend Help: Choosing the right Sender ID](https://help.clicksend.com/en/articles/42309-choosing-the-right-sender-id) · [ClickSend Help: How to view reports](https://help.clicksend.com/en/articles/42316-how-to-view-reports)

## Call create\_sms\_campaign from a script

curl

```
curl -X POST https://cotlet.dev/api/v1/clicksend/lists/128734/sms-campaigns \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Black Friday teaser","from":"+15550100188","message":"Hi [First Name], Black Friday starts Nov 27. Subscribers shop first: shop.example.com/bf","opt_out":"reply_stop","send_at":"2026-10-26 09:00"}'
```

Example response

```
{
"campaign_id": 48213,
"name": "Black Friday teaser",
"status": "scheduled",
"list": "Newsletter subscribers",
"recipients": 1840,
"from": "+15550100188",
"send_at": "2026-10-26 09:00",
"message_parts": 1,
"cost": "73.60"
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is clicksend\_write → create\_sms\_campaign. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/clicksend-api-mcp-server.md#automations)

## ClickSend tools this automation uses

__Cotlet ClickSend tools used to schedule a ClickSend SMS campaign to a contact list__
| Tool | Parameters |
| --------------------- | ------------------------------------------------- |
| list\_contact\_lists | query, cursor |
| create\_sms\_campaign | name, list\_id, from, message, opt\_out, send\_at |
| list\_sms\_campaigns | status, cursor |

[All 15 ClickSend tools with descriptions](https://cotlet.dev/integrations/clicksend-api-mcp-server.md#tools)

## Frequently asked questions

### Is it safe to connect ClickSend to Cotlet?

Yes. You sign in to ClickSend yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get ClickSend once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

## More ClickSend automations

- [Remove opted-out contacts from ClickSend lists](https://cotlet.dev/integrations/clicksend-api-mcp-server/remove-opted-out-contacts.md)
- [Find failed ClickSend texts and see why they failed](https://cotlet.dev/integrations/clicksend-api-mcp-server/find-failed-sms.md)
- [ClickSend API and MCP server: every tool](https://cotlet.dev/integrations/clicksend-api-mcp-server.md)
- [All use cases](https://cotlet.dev/use-cases.md)

## Give your agent access to ClickSend.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with ClickSend.

[Sign up free](https://cotlet.dev/app/signup?app=clicksend)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.