APILinkedIn Messaging
Mark conversation as seen
Mark a LinkedIn conversation as seen/read. This updates the read status for the sender and removes the unread indicator. Useful for managing inbox state programmatically.
POST
/messaging/mark-seenAuthentication requiredMessaging
Code Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/messaging/mark-seen' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"conversationUrn":"urn:li:msg_conversation:(urn:li:fsd_profile:ACoAAATPlQ0Bc8wdg-Iy8wZgEDuSdIVWJiE1Aio,2-NzkzMDFlNzAtZjU2OS00MjIwLWE2ZDctYzZkMWE1ZDljZDAyXzEwMA==)"}'Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID to use. If not provided, uses the default account. |
conversationUrn | string | Yes | LinkedIn conversation URN to mark as seen |
Example
{
"conversationUrn": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAAATPlQ0Bc8wdg-Iy8wZgEDuSdIVWJiE1Aio,2-NzkzMDFlNzAtZjU2OS00MjIwLWE2ZDctYzZkMWE1ZDljZDAyXzEwMA==)"
}Responses
| Status | Description |
|---|---|
| 200 | Conversation marked as seen successfully |
| 400 | Bad request - Missing required parameter |
| 401 | Unauthorized - Invalid or missing API key |
| 500 | Server error or failed to mark conversation |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
accountId | string | |
conversationUrn | string | |
message | string |
200 Example
{
"success": true,
"accountId": "696ce9e780e0483585e4e553",
"conversationUrn": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAAATPlQ0Bc8wdg-Iy8wZgEDuSdIVWJiE1Aio,2-NzkzMDFlNzAtZjU2OS00MjIwLWE2ZDctYzZkMWE1ZDljZDAyXzEwMA==)",
"message": "Conversation marked as seen successfully"
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
error | object |
400 Example
{
"success": false,
"error": "conversationUrn is required"
}401 Example
{
"error": "Unauthorized - Invalid credentials"
}500 Example
{
"success": false,
"accountId": "696ce9e780e0483585e4e553",
"conversationUrn": "urn:li:msg_conversation:...",
"message": "Failed to mark conversation as seen"
}Send group message with delivery acknowledgment
Send a LinkedIn message using group context while acknowledging delivery of previous messages. Useful for group-based conversations where you want to track message delivery. Rate limit: 150 messages per day per account.
Mark all messages as read
Mark all LinkedIn messages as read for the authenticated account. Clears all unread indicators in the inbox. Useful for bulk inbox management.
