Email & SMS

Get Text

Returns the text message identified by the given communication ID. The communication must be a text record, and the caller must have manage permission on the owning lead; otherwise 400 PERMISSION_DENIED is returned (no existence leak).

Webhook follow-up: when a Text webhook is delivered, pass each createdText[].timelineId from the payload as the communicationId path parameter to fetch the full record. The legacy createdText[].textId field is kept for backward compatibility but is not interchangeable across communicationType — prefer timelineId.

GET

v2.0

communication

text

{communicationId}

Get a text message by ID

curl --request GET \
  --url https://api.lofty.com/v2.0/communication/text/{communicationId} \
  --header 'Authorization: <authorization>'

{
  "id": 123,
  "leadId": 123,
  "direction": "Outbound",
  "agentId": 123,
  "textOutcome": "Delivered",
  "textTime": "<string>",
  "textType": "Auto",
  "textContent": "Content"
}

Headers

Authorization

string

required

Bearer [access_token]

Path Parameters

communicationId

integer<int64>

required

Communication ID of the text message.

Required range: x >= 1

Response

Text message retrieved successfully.

integer<int64>

The ID of the text

leadId

integer<int64>

The lead(Id) associated with the text

direction

string

Outbound or Inbound text

Example:

"Outbound"

agentId

integer<int64>

The related Agent ID

textOutcome

string

Text delivery status

Example:

"Delivered"

textTime

string

The sending time of the text

textType

string

Manual or Auto text

Example:

"Auto"

textContent

string

The content of the text

Example:

"Content"

Send SMS

Send Opportunity Alert

Get a text message by ID

curl --request GET \
  --url https://api.lofty.com/v2.0/communication/text/{communicationId} \
  --header 'Authorization: <authorization>'

{
  "id": 123,
  "leadId": 123,
  "direction": "Outbound",
  "agentId": 123,
  "textOutcome": "Delivered",
  "textTime": "<string>",
  "textType": "Auto",
  "textContent": "Content"
}