Email & SMS

Get Email

Returns the email identified by the given communication ID. The communication must be an email 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 an Email webhook is delivered, pass each createdEmail[].timelineId from the payload as the communicationId path parameter to fetch the full record. The legacy createdEmail[].emailId field is kept for backward compatibility but is not interchangeable across communicationType — prefer timelineId.

GET

v2.0

communication

{communicationId}

Get an email by ID

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

{
  "id": 123,
  "leadId": 123,
  "direction": "Outbound",
  "agentId": 123,
  "eventType": "Sent",
  "emailEventTime": "<string>",
  "emailType": "Auto",
  "emailSubject": "<string>",
  "fromPond": true
}

Headers

Authorization

string

required

Bearer [access_token]

Path Parameters

communicationId

integer<int64>

required

Communication ID of the email.

Required range: x >= 1

Response

Email retrieved successfully.

integer<int64>

The ID of the email

leadId

integer<int64>

The lead(Id) associated with the email

direction

string

Outbound or Inbound email

Example:

"Outbound"

agentId

integer<int64>

The related Agent ID

eventType

string

Sent, Opened or Bounced event

Example:

"Sent"

emailEventTime

string

The event time of the email

emailType

string

Manual or Auto email

Example:

"Auto"

emailSubject

string

The subject of the email

fromPond

boolean

Is the email sent from the lead pond

Send Email

SMS History

Get an email by ID

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

{
  "id": 123,
  "leadId": 123,
  "direction": "Outbound",
  "agentId": 123,
  "eventType": "Sent",
  "emailEventTime": "<string>",
  "emailType": "Auto",
  "emailSubject": "<string>",
  "fromPond": true
}