List Inbox
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": {
"count": 123,
"category": "<string>",
"cursor": "<string>"
}
}
'{
"success": true,
"data": {
"conversations": [
{
"conversation_id": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAA...,2-MDZiY2ExOTgtM2NjNy00OTU4LTgyNjUtZWFlMmIwZjM1NTlmXzEwMA==)",
"participant": {
"name": "Jane Doe",
"headline": "Founder at Acme Corp",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg"
},
"last_message": {
"text": "Sounds good, talk soon!",
"time": 1777147641366,
"sender": {
"name": "Jane Doe",
"headline": "Founder at Acme Corp",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
"is_me": false
}
},
"unread": 0,
"type": "normal"
}
],
"total_results": 1,
"next_cursor": "REVTQ0VORElORyYxNzc0OTU4MDE2NjQzJjItWlRFMk1qazBaV1F0Wm1JMFlpMDBNR1k1TFRrMlptTXRaRGcwWVRjM05qUTJZakExWHpFd01BPT0="
},
"metadata": {
"action": "list_inbox",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Messaging
List Inbox
Retrieve a list of conversations from the inbox.
POST
/
v2
/
messages
List Inbox
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": {
"count": 123,
"category": "<string>",
"cursor": "<string>"
}
}
'{
"success": true,
"data": {
"conversations": [
{
"conversation_id": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAA...,2-MDZiY2ExOTgtM2NjNy00OTU4LTgyNjUtZWFlMmIwZjM1NTlmXzEwMA==)",
"participant": {
"name": "Jane Doe",
"headline": "Founder at Acme Corp",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg"
},
"last_message": {
"text": "Sounds good, talk soon!",
"time": 1777147641366,
"sender": {
"name": "Jane Doe",
"headline": "Founder at Acme Corp",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
"is_me": false
}
},
"unread": 0,
"type": "normal"
}
],
"total_results": 1,
"next_cursor": "REVTQ0VORElORyYxNzc0OTU4MDE2NjQzJjItWlRFMk1qazBaV1F0Wm1JMFlpMDBNR1k1TFRrMlptTXRaRGcwWVRjM05qUTJZakExWHpFd01BPT0="
},
"metadata": {
"action": "list_inbox",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Overview
Returns a paginated list of conversations from the inbox. Filter by category and paginate with thenext_cursor value.
This endpoint consumes 1 credit per 10 results returned. LinkedIn returns up to 25 conversations per internal request, so larger
total_results values trigger multiple upstream calls automatically.Request
Your API key for authentication.
The unique identifier of the account to use.
Must be
"list_inbox".Show params properties
Show params properties
Maximum number of conversations to return. Defaults to
10.Filter conversations by category. One of:
"INBOX", "UNREAD", "MY_CONNECTIONS", "INMAIL", "STARRED". Defaults to "INBOX".Cursor returned by a previous response as
data.next_cursor. Omit for the first page.Response
Indicates whether the request was successful.
Show data properties
Show data properties
List of conversation objects.
Show conversation properties
Show conversation properties
LinkedIn conversation URN, of the form
urn:li:msg_conversation:(urn:li:fsd_profile:...,2-...).The other side of the conversation. Can be a member, a company page, or — for notes-to-self — your own profile.
Show participant properties
Show participant properties
Display name (member full name or company name).
LinkedIn headline (or company tagline if
is_organization).LinkedIn profile URL (or company page URL if
is_organization).Profile picture URL (or company logo if
is_organization).Present and
true when the participant is a LinkedIn company page (e.g. Sponsored InMail, brand outreach). Absent for human members.The most recent message in the conversation.
Show last_message properties
Show last_message properties
Plain-text content of the message.
Unix epoch timestamp in milliseconds when the message was sent.
Author of the last message.
Number of unread messages in the conversation.
0 when fully read.Conversation type. Common values:
"normal", "inmail", "Sponsored".Number of conversations returned in this response.
Cursor to send as
next_cursor in the next request to resume pagination. null when the end is reached.{
"success": true,
"data": {
"conversations": [
{
"conversation_id": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAA...,2-MDZiY2ExOTgtM2NjNy00OTU4LTgyNjUtZWFlMmIwZjM1NTlmXzEwMA==)",
"participant": {
"name": "Jane Doe",
"headline": "Founder at Acme Corp",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg"
},
"last_message": {
"text": "Sounds good, talk soon!",
"time": 1777147641366,
"sender": {
"name": "Jane Doe",
"headline": "Founder at Acme Corp",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
"is_me": false
}
},
"unread": 0,
"type": "normal"
}
],
"total_results": 1,
"next_cursor": "REVTQ0VORElORyYxNzc0OTU4MDE2NjQzJjItWlRFMk1qazBaV1F0Wm1JMFlpMDBNR1k1TFRrMlptTXRaRGcwWVRjM05qUTJZakExWHpFd01BPT0="
},
"metadata": {
"action": "list_inbox",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Was this page helpful?
⌘I