List conversations
Conversations in the Inbox with the last message of each.
GET https://cotlet.dev/api/v1/simpletexting/conversations
read
Reads the Inbox as it shows it: one row per contact with the last message, its direction (incoming or outgoing) and who the conversation is assigned to. Replies to campaigns are included, because SimpleTexting delivers them to the Inbox. Filter by a search on the contact or by assignee. Page with next_cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Contact name or phone number. |
| assigned_to string | string | Name of a team member. Leave out for all conversations. |
| limit integer | integer | Page size. |
| cursor string | string | next_cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/simpletexting/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("simpletexting", "list_conversations")const result = await cotlet.call('simpletexting', 'list_conversations');cotlet call simpletexting list_conversationsExample response
{
"conversations": [
{
"conversation_id": "c_8f21a6",
"contact": {
"name": "Dana Whitfield",
"phone": "+12125550147"
},
"last_message": {
"direction": "incoming",
"text": "Can I move my cleaning to Friday?",
"at": "2026-10-23T09:12:00-04:00"
},
"assigned_to": null
},
{
"conversation_id": "c_5b09d3",
"contact": {
"name": "Marcus Lee",
"phone": "+12125550163"
},
"last_message": {
"direction": "outgoing",
"text": "See you at 3 pm.",
"at": "2026-10-22T16:40:00-04:00"
},
"assigned_to": "Priya Nair"
}
],
"next_cursor": null
}