List conversations
List recent LinkedIn conversations using DB-first approach with LinkedIn API fallback. Supports multi-account batch queries, label/unread filtering. Auto-detects Sales Navigator accounts and merges Sales Nav threads with standard conversations.
/conversationsCode Examples
curl -X GET 'https://api.connectsafely.ai/linkedin/conversations' \ -H 'Authorization: Bearer <your_api_key>'Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
accountId | query | No | string | Single LinkedIn account ID |
linkedinAccountIds | query | No | string | Comma-separated account IDs for multi-account batch |
count | query | No | number | Number of conversations |
nextCursor | query | No | string | Pagination cursor (prefixed "linkedin:" for API pagination) |
labelId | query | No | string | Filter by label ID |
unreadOnly | query | No | boolean | Only unread conversations |
labeledOnly | query | No | boolean | Only labeled conversations |
Request Body
No request body.
Responses
| Status | Description |
|---|---|
| 200 | Conversations list |
| 401 | Unauthorized |
| 404 | Account not found |
| 500 | Server error |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
conversations | array | |
accounts | array | |
nextCursor | string | |
hasMore | boolean | |
fromCache | boolean |
200 Example
{
"success": true,
"conversations": [
{
"conversationUrn": "urn:li:example:123456",
"conversationId": "conv_abcdef123456",
"lastActivityAt": "example_value",
"unreadCount": 25,
"participants": [],
"latestMessage": {},
"source": "example_value",
"salesNavThreadId": "12345"
}
],
"accounts": [
{
"id": "12345",
"name": "example_value"
}
],
"nextCursor": "example_value",
"hasMore": true,
"fromCache": true
}401 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
401 Example
{
"error": "example_value"
}404 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
404 Example
{
"error": "example_value"
}500 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
500 Example
{
"error": "example_value"
}LinkedIn Messaging API
Send LinkedIn messages via API, retrieve conversations, and build automated outreach sequences. Supports typing indicators and delivery tracking.
Get conversation messages
Retrieve messages for a specific conversation. Auto-detects Sales Navigator thread URNs (urn:li:salesNav_thread:*) and routes to the Sales Nav API. Standard conversations use DB-first with LinkedIn API fallback for older messages via cursor pagination. Replaces GET /messaging/conversation-details.