APILinkedIn Messaging
List Sales Navigator threads
List messaging threads from Sales Navigator. Requires active Sales Navigator subscription. Supports INBOX/UNREAD/ARCHIVED filtering. Note: GET /conversations automatically merges Sales Nav threads — use this endpoint only if you need Sales Nav-specific filtering (UNREAD/ARCHIVED).
GET
/sales-nav/threadsAuthentication requiredSales Navigator
Code Examples
curl -X GET 'https://api.connectsafely.ai/linkedin/sales-nav/threads' \ -H 'Authorization: Bearer <your_api_key>'Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
accountId | query | No | string | LinkedIn account ID |
count | query | No | number | Number of threads |
filter | query | No | string | Thread filter |
pageStartsAt | query | No | number | Pagination offset |
Request Body
No request body.
Responses
| Status | Description |
|---|---|
| 200 | Threads list |
| 400 | Not a Sales Navigator account |
| 401 | Unauthorized |
| 404 | Account not found |
| 500 | Server error |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
threads | array | |
paging | object | |
nextPageStartsAt | number | |
accountId | string |
200 Example
{
"success": true,
"threads": [],
"paging": {},
"nextPageStartsAt": 0,
"accountId": "acc_12345"
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string | |
success | boolean | |
premiumType | string |
400 Example
{
"error": "example_value",
"success": true,
"premiumType": "default"
}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"
}Refresh conversation messages
Trigger background refresh of messages for a conversation. Results pushed via WebSocket.
Get Sales Navigator thread with messages
Get a single Sales Navigator thread with message history. Note: GET /conversations/{conversationUrn}/messages auto-detects Sales Nav URNs and serves the same data.
