Skip to main content
POST
/
v1.0
/
logType
Add a manual log entry
curl --request POST \
  --url https://api.lofty.com/v1.0/logType \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "leadId": 563172647619608,
  "logType": "logCall",
  "content": "Discussed Austin inventory, will send pre-approval doc tomorrow.",
  "leadPhoneNumber": "5865865860",
  "callingOutcome": "VoiceMessage",
  "outboundOrInbound": "outbound",
  "isPin": false,
  "emailSubject": "Follow-up on Austin listings",
  "toEmail": "sarah.johnson@example.com",
  "fromEmail": "agent@lofty.com"
}
'
{
  "logType": {
    "id": 563172647619608,
    "leadId": 100001,
    "leadPhoneNumber": "5865865860",
    "callingOutcome": "VoiceMessage",
    "content": "Discussed Austin inventory, will send pre-approval doc tomorrow.",
    "createTime": "2026-04-22 10:15:30",
    "outboundOrInbound": "outbound",
    "isPin": false,
    "agentId": 100234,
    "emailSubject": "Follow-up on Austin listings",
    "toEmail": "sarah.johnson@example.com",
    "fromEmail": "agent@lofty.com"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.lofty.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer [access_token]

​
Content-Type
string
required

application/json

Body

application/json

Manual log entry payload.

​
leadId
integer<int64>
required

ID of the lead to attach this log to. Must be accessible to the caller.

Example:

563172647619608

​
logType
enum<string>
required

Channel of the manual log entry.

Available options:
logCall,
logEmail,
logText
Example:

"logCall"

​
content
string
required

Free-text body of the log entry: call notes, email body, or SMS content. Silently truncated to 5000 characters.

Maximum string length: 5000
Example:

"Discussed Austin inventory, will send pre-approval doc tomorrow."

​
leadPhoneNumber
string

Phone number that was called. Required when logType = logCall. Max 20 characters.

Maximum string length: 20
Example:

"5865865860"

​
callingOutcome
enum<string>

Outcome of the call. Only meaningful when logType = logCall. Max 20 characters.

Available options:
Talked,
VoiceMessage,
NoAnswer,
BadNumber,
DNCNumber,
DNCContact
Maximum string length: 20
Example:

"VoiceMessage"

​
outboundOrInbound
enum<string>
default:outbound

Direction of the communication from the agent's point of view. 'outbound' = agent -> lead; 'inbound' = lead -> agent. Defaults to 'outbound' when omitted.

Available options:
outbound,
inbound
Example:

"outbound"

​
isPin
boolean
default:false

Whether to pin this entry to the top of the lead's timeline.

Example:

false

​
emailSubject
string

Email subject. Only meaningful when logType = logEmail; ignored otherwise.

Example:

"Follow-up on Austin listings"

​
toEmail
string

Recipient email address. Only meaningful when logType = logEmail; ignored otherwise.

Example:

"sarah.johnson@example.com"

​
fromEmail
string

Sender email address. Only meaningful when logType = logEmail; ignored otherwise.

Example:

"agent@lofty.com"

Response

Entry accepted for persistence. The response contains the newly assigned ID.

Wrapped response for GET /v1.0/logType/{id} and POST /v1.0/logType. The manual log entry is returned under the 'logType' key.

​
logType
object

Manual log entry.