Messages
Unified inbox API for managing conversations and direct messages across all connected accounts. All endpoints aggregate data from multiple social accounts in a single API call. Requires Inbox addon.
List conversations across all accounts
Fetch conversations (DMs) from all connected messaging accounts in a single API call. Supports filtering by profile and platform. Results are aggregated and deduplicated.
Supported platforms: Facebook, Instagram, Bluesky, Reddit, Telegram
API key authentication - use your Late API key as a Bearer token
In: header
Query Parameters
Filter by profile ID
Filter by platform
"facebook" | "instagram" | "bluesky" | "reddit" | "telegram"Filter by conversation status
"active" | "archived"Sort order by updated time
"desc""asc" | "desc"Maximum number of conversations to return
501 <= value <= 100Pagination cursor for next page
Filter by specific social account ID
Response Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/inbox/conversations"{
"data": [
{
"id": "string",
"platform": "string",
"accountId": "string",
"accountUsername": "string",
"participantId": "string",
"participantName": "string",
"participantPicture": "string",
"lastMessage": "string",
"updatedTime": "2019-08-24T14:15:22Z",
"status": "active",
"unreadCount": 0,
"url": "string"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "string"
},
"meta": {
"accountsQueried": 0,
"accountsFailed": 0,
"failedAccounts": [
{
"accountId": "string",
"accountUsername": "string",
"platform": "string",
"error": "string",
"code": "string",
"retryAfter": 0
}
],
"lastUpdated": "2019-08-24T14:15:22Z"
}
}{
"error": "Unauthorized"
}Get conversation details
Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
Query Parameters
The social account ID
Response Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/inbox/conversations/string?accountId=string"{
"data": {
"id": "string",
"accountId": "string",
"accountUsername": "string",
"platform": "string",
"status": "active",
"participantName": "string",
"participantId": "string",
"lastMessage": "string",
"lastMessageAt": "2019-08-24T14:15:22Z",
"updatedTime": "2019-08-24T14:15:22Z",
"participants": [
{
"id": "string",
"name": "string"
}
]
}
}{
"error": "Unauthorized"
}Update conversation status
Archive or activate a conversation. Requires accountId in request body.
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
Social account ID
"active" | "archived"Response Body
application/json
application/json
curl -X PUT "https://getlate.dev/api/v1/inbox/conversations/string" \ -H "Content-Type: application/json" \ -d '{ "accountId": "string", "status": "active" }'{
"success": true,
"data": {
"id": "string",
"accountId": "string",
"status": "active",
"platform": "string",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Unauthorized"
}Get messages in a conversation
Fetch messages for a specific conversation. Requires accountId query parameter.
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
Query Parameters
Social account ID
Response Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/inbox/conversations/string/messages?accountId=string"{
"status": "string",
"messages": [
{
"id": "string",
"conversationId": "string",
"accountId": "string",
"platform": "string",
"message": "string",
"senderId": "string",
"senderName": "string",
"direction": "incoming",
"createdAt": "2019-08-24T14:15:22Z",
"attachments": [
{
"id": "string",
"type": "image",
"url": "string",
"filename": "string",
"previewUrl": "string"
}
],
"subject": "string",
"storyReply": true,
"isStoryMention": true
}
],
"lastUpdated": "2019-08-24T14:15:22Z"
}{
"error": "Unauthorized"
}Send a message
Send a message in a conversation. Requires accountId in request body.
Attachment support by platform:
- Telegram: Images, videos, documents (up to 50MB)
- Facebook Messenger: Images, videos, audio, files
- Twitter/X: Images, videos (requires media upload)
- Instagram: Not supported (API limitation)
- Bluesky: Not supported (API limitation)
- Reddit: Not supported (API limitation)
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
Social account ID
Message text
Response Body
application/json
application/json
application/json
curl -X POST "https://getlate.dev/api/v1/inbox/conversations/string/messages" \ -H "Content-Type: application/json" \ -d '{ "accountId": "string", "message": "string" }'{
"success": true,
"data": {
"messageId": "string",
"conversationId": "string",
"sentAt": "2019-08-24T14:15:22Z",
"message": "string"
}
}{
"error": "string",
"code": "PLATFORM_LIMITATION"
}{
"error": "Unauthorized"
}Analytics
Retrieve post performance metrics, engagement data, and analytics via the Late API
Comments
Unified inbox API for managing comments on posts across all connected accounts. Supports commenting on third-party posts for platforms that allow it (YouTube, Twitter, Reddit, Bluesky, Threads). All endpoints aggregate data from multiple social accounts in a single API call. Requires Inbox addon.