Get Conversation
curl --request POST \
--url https://api.linkupapi.com/v2/messages \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"conversation_id": "<string>",
"profile_url": "<string>",
"count": 123,
"cursor": "<string>"
}
}
'{
"success": true,
"data": {
"total_message_count": 55,
"unread_count": 0,
"last_seen_message": true,
"last_seen_at": 1777147641366,
"messages": [
{
"text": "Sounds good, talk soon!",
"timestamp": 1777147641366,
"sender": "Jane Doe",
"sender_info": {
"first_name": "Jane",
"last_name": "Doe",
"profile_url": "https://www.linkedin.com/in/jane-doe-42/"
},
"message_type": "TEXT",
"entity_urn": "urn:li:msg_message:(urn:li:fsd_profile:ACoAA...,2-MTc3NzE0...)"
},
{
"text": "Hey, are you available for a call tomorrow?",
"timestamp": 1777146492678,
"sender": "John Smith",
"sender_info": {
"first_name": "John",
"last_name": "Smith",
"profile_url": "https://www.linkedin.com/in/john-smith-99/"
},
"message_type": "TEXT",
"entity_urn": "urn:li:msg_message:(urn:li:fsd_profile:ACoAA...,2-MTc3NzE0...)"
}
],
"next_cursor": "1777146285823"
},
"metadata": {
"action": "get_conversation",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Messaging
Get Conversation
Retrieve messages from a specific conversation.
POST
/
v2
/
messages
Get Conversation
curl --request POST \
--url https://api.linkupapi.com/v2/messages \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"conversation_id": "<string>",
"profile_url": "<string>",
"count": 123,
"cursor": "<string>"
}
}
'{
"success": true,
"data": {
"total_message_count": 55,
"unread_count": 0,
"last_seen_message": true,
"last_seen_at": 1777147641366,
"messages": [
{
"text": "Sounds good, talk soon!",
"timestamp": 1777147641366,
"sender": "Jane Doe",
"sender_info": {
"first_name": "Jane",
"last_name": "Doe",
"profile_url": "https://www.linkedin.com/in/jane-doe-42/"
},
"message_type": "TEXT",
"entity_urn": "urn:li:msg_message:(urn:li:fsd_profile:ACoAA...,2-MTc3NzE0...)"
},
{
"text": "Hey, are you available for a call tomorrow?",
"timestamp": 1777146492678,
"sender": "John Smith",
"sender_info": {
"first_name": "John",
"last_name": "Smith",
"profile_url": "https://www.linkedin.com/in/john-smith-99/"
},
"message_type": "TEXT",
"entity_urn": "urn:li:msg_message:(urn:li:fsd_profile:ACoAA...,2-MTc3NzE0...)"
}
],
"next_cursor": "1777146285823"
},
"metadata": {
"action": "get_conversation",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Overview
Returns messages from a specific conversation, ordered from most recent to oldest. Identify the conversation byconversation_id or by passing a profile_url (the conversation with that user is resolved automatically). Pagination is cursor-based — pass the next_cursor returned by a previous call to fetch older messages.
This endpoint consumes 1 credit per 10 messages returned.
Request
Your API key for authentication.
The unique identifier of the account to use.
Must be
"get_conversation".Show params properties
Show params properties
LinkedIn conversation URN. Required if
profile_url is not provided.The profile URL of the other participant. Also accepts
linkedin_url as an alias. When provided, the conversation with this user is resolved automatically. Required if conversation_id is not provided.Number of messages to return. Defaults to
10.Cursor returned by a previous response as
data.next_cursor. Omit for the first page (most recent messages).Response
Indicates whether the request was successful.
Show data properties
Show data properties
Total number of messages in the conversation (across all pages).
Number of unread messages in the conversation.
true when the most recent message in this batch has been read by the recipient.Unix epoch timestamp in milliseconds when the recipient last read the conversation. Omitted if no read receipt is available.
Messages from the conversation, sorted most recent first.
Show message properties
Show message properties
Plain-text body of the message.
Unix epoch timestamp in milliseconds when the message was delivered.
Display name of the sender.
Message type. Common values:
"TEXT", "INVITATION", "SHARED_POST".LinkedIn URN of the message.
Cursor (epoch-ms timestamp of the oldest message in this batch) to send as
cursor in the next request to fetch older messages. Omitted when there are no more messages.{
"success": true,
"data": {
"total_message_count": 55,
"unread_count": 0,
"last_seen_message": true,
"last_seen_at": 1777147641366,
"messages": [
{
"text": "Sounds good, talk soon!",
"timestamp": 1777147641366,
"sender": "Jane Doe",
"sender_info": {
"first_name": "Jane",
"last_name": "Doe",
"profile_url": "https://www.linkedin.com/in/jane-doe-42/"
},
"message_type": "TEXT",
"entity_urn": "urn:li:msg_message:(urn:li:fsd_profile:ACoAA...,2-MTc3NzE0...)"
},
{
"text": "Hey, are you available for a call tomorrow?",
"timestamp": 1777146492678,
"sender": "John Smith",
"sender_info": {
"first_name": "John",
"last_name": "Smith",
"profile_url": "https://www.linkedin.com/in/john-smith-99/"
},
"message_type": "TEXT",
"entity_urn": "urn:li:msg_message:(urn:li:fsd_profile:ACoAA...,2-MTc3NzE0...)"
}
],
"next_cursor": "1777146285823"
},
"metadata": {
"action": "get_conversation",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Was this page helpful?
⌘I