/v1/comms/textsRead the text message log
Every SMS and iMessage this workspace sent or received, newest first, across every thread. Narrow with direction, or by record: definitionKey (the page's key, like "leads") or definitionId (its uuid), with rowId repeated for several records (rowId=a&rowId=b) or left out for every record on the page. ONE CALL FOR MANY RECORDS — never one call per record (2026-10-08: a review of 30 leads read their texts one at a time and ran out of time). Start here for "what have we texted them".
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
"inbound" · "outbound"
Responses
the action's answer
{
"texts": [
{
"call": "string",
"contact_identifier": "string",
"contact_name": "string",
"content": "string",
"conversation_id": 1.5,
"delivery": {
"attempts": 1.5,
"claimed_by": "string",
"error": "string",
"next_attempt_at": "string",
"state": "string"
},
"direction": "string",
"external_id": "",
"id": 1.5,
"is_deleted": true,
"medium": "string",
"occurred_at": "string",
"recorded_at": "string",
"sender_id": "",
"sender_name": "string",
"sender_type": "string",
"status": "string",
"text": {
"error_code": "string",
"error_message": "string",
"media_count": 1.5,
"provider": "string",
"segment_count": 1.5
}
}
],
"total": 1.5
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}