[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)

# Send SMS

> Send one text now or later to numbers or to a list, as Quick SMS does. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/clicksend/send_sms

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Send one text now or later to numbers or to a list, as Quick SMS does.

ClickSend API: https://cotlet.dev/docs/api/clicksend.md

`POST https://cotlet.dev/api/v1/clicksend/sms`

Access: write. Confirm: waits for the user's OK before it runs.

Sends like Quick SMS: to up to 1,000 numbers or contacts at once, now or at send_at. Give to or list_id. It spends account credit, and the confirmation shows the cost as Preview and Confirm does. Quick SMS has no Reply STOP and no unsubscribe link, so for a marketing text use create_sms_campaign. A text scheduled this way cannot be edited, only cancelled with cancel_scheduled_sms. By default you confirm each call; you can switch that off for this tool.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `to` | array | no | Phone numbers with the country code, for example +447700900142. |
| `list_id` | integer | no | Send to this contact list instead of to. |
| `from` | string | yes | Sender as the From field shows it: a dedicated number, an own number you verified, an alpha tag (up to 11 characters, no spaces), a shared number or Smart Senders. |
| `message` | string | yes | Text of the message. Placeholders such as [First Name] work with a list. |
| `send_at` | string | no | Send time, YYYY-MM-DD HH:MM, in the timezone set in your ClickSend Dashboard. Up to 4 months ahead. Leave out to send now. |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/clicksend/sms \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"from","message":"message"}'
```

**Python**

```python
result = client.call("clicksend", "send_sms", {"from":"from","message":"message"})
```

**Node.js**

```js
const result = await cotlet.call('clicksend', 'send_sms', {"from":"from","message":"message"});
```

**CLI**

```bash
cotlet call clicksend send_sms --data '{"from":"from","message":"message"}'
```

## Example response

```json
{
  "status": "scheduled",
  "recipients": 2,
  "from": "+15550100188",
  "send_at": "2026-10-24 10:00",
  "message_parts": 1,
  "cost": "0.08",
  "message_ids": [
    "3B9A5E70-12C4-4D8F-A6B3-0E7D4C2F1A58",
    "9C4E2A61-7F0D-4B35-8E19-6D2A0B7C4F13"
  ]
}
```

Previous: [List inbound rules](https://cotlet.dev/docs/api/clicksend/list_inbound_rules.md)
Next: [Create SMS campaign](https://cotlet.dev/docs/api/clicksend/create_sms_campaign.md)

---

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.