Send an SMS
Sends a text message from one of your mobile numbers to a phone number.
POST https://cotlet.dev/api/v1/ringover/froms/{from_number}/sms
write Confirm
Sends the SMS as the Message > SMS > + New form does: from a mobile number assigned to your user, to a phone number, with your text. Ringover splits the text into 160-character fragments, bills each fragment and allows at most 8 segments. Needs a Business plan. With send_at the message is scheduled instead of sent now. It returns the message with its state; a failed message can be sent again. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| from_number string required | string | A mobile number assigned to your user, the sender ID, with country code. |
| to_number string required | string | The recipient phone number with country code. |
| body string required | string | The message text. |
| send_at datetime | datetime | ISO 8601 time to send later. Omit to send now. |
Request
curl -X POST https://cotlet.dev/api/v1/ringover/froms/%2B15550100100/sms \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to_number":"+15550100142","body":"Hi Dana, sorry we missed your call. We will call you back today."}'result = client.call("ringover", "send_sms", {"from_number":"+15550100100","to_number":"+15550100142","body":"Hi Dana, sorry we missed your call. We will call you back today."})const result = await cotlet.call('ringover', 'send_sms', {"from_number":"+15550100100","to_number":"+15550100142","body":"Hi Dana, sorry we missed your call. We will call you back today."});cotlet call ringover send_sms --data '{"from_number":"+15550100100","to_number":"+15550100142","body":"Hi Dana, sorry we missed your call. We will call you back today."}'Example response
{
"message_id": "msg_7710",
"conversation_id": "sms_3301",
"from_number": "+15550100100",
"to_number": "+15550100142",
"body": "Hi Dana, sorry we missed your call. We will call you back today.",
"state": "sent",
"sent_at": "2026-10-22T09:40:00Z"
}