Schedule message
Schedule a text to one contact for a date and time.
POST https://cotlet.dev/api/v1/simpletexting/message/schedule
write Confirm
Does what the Clock icon in the Inbox does: the text goes to one contact at the time you give. Returns the scheduled message id. SimpleTexting does not let you edit a scheduled message, so a change means deleting it in the app (three dots, delete) and scheduling a new one. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| contact_phone string required | string | Phone number of the contact, with country code. |
| text string required | string | Message text. |
| send_at datetime required | datetime | When to send, ISO 8601 with offset. |
Request
curl -X POST https://cotlet.dev/api/v1/simpletexting/message/schedule \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_phone":"contact phone","text":"text","send_at":"2026-10-01T09:00:00Z"}'result = client.call("simpletexting", "schedule_message", {"contact_phone":"contact phone","text":"text","send_at":"2026-10-01T09:00:00Z"})const result = await cotlet.call('simpletexting', 'schedule_message', {"contact_phone":"contact phone","text":"text","send_at":"2026-10-01T09:00:00Z"});cotlet call simpletexting schedule_message --data '{"contact_phone":"contact phone","text":"text","send_at":"2026-10-01T09:00:00Z"}'Example response
{
"scheduled_message_id": "sm_2e90b1",
"contact_phone": "+12125550163",
"send_at": "2026-10-27T08:00:00-04:00",
"status": "scheduled"
}