Send message

Send a text to one contact, as a reply in the Inbox or as a new conversation.

POST https://cotlet.dev/api/v1/simpletexting/messages

write Confirm

Sends one text to a contact from the account number, in the contact's conversation. Returns the message id and its time. A sent text cannot be taken back. The agent should read the thread with get_conversation first. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: send_message
NameTypeDescription
contact_phone string required string Phone number of the contact, with country code.
text string required string Message text.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/simpletexting/messages \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_phone":"+12125550147","text":"Yes, Friday works. We have 10 am open. Reply YES to confirm."}'
Python
result = client.call("simpletexting", "send_message", {"contact_phone":"+12125550147","text":"Yes, Friday works. We have 10 am open. Reply YES to confirm."})
Node.js
const result = await cotlet.call('simpletexting', 'send_message', {"contact_phone":"+12125550147","text":"Yes, Friday works. We have 10 am open. Reply YES to confirm."});
CLI
cotlet call simpletexting send_message --data '{"contact_phone":"+12125550147","text":"Yes, Friday works. We have 10 am open. Reply YES to confirm."}'

Example response

JSON

{
  "message_id": "m_77d0c4",
  "conversation_id": "c_8f21a6",
  "contact_phone": "+12125550147",
  "direction": "outgoing",
  "status": "sent",
  "at": "2026-10-23T09:30:00-04:00"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.