POST
/
v1
/
messages
/
inbox
curl --request POST \
  --url https://api.linkupapi.com/v1/messages/inbox \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "total_results": 123,
  "country": "<string>",
  "login_token": "<string>"
}'
{
  "status": "success",
  "data": {
    "total_results": 1,
    "conversations": [
      {
        "conversation_id": "urn:li:conversation:123456789",
        "participant": {
          "name": "John Doe",
          "headline": "Software Engineer at Tech Company",
          "profile_url": "https://www.linkedin.com/in/johndoe/"
        },
        "last_message": {
          "text": "Thanks for connecting!",
          "time": 1679529600000
        },
        "unread": 1,
        "type": "normal"
      }
    ]
  }
}

Get a list of messaging conversations from your LinkedIn inbox, including information about participants and latest messages.

Credit Usage: 1 credit per 10 results (or fraction thereof). For example:

  • 1-10 results = 1 credit
  • 11-20 results = 2 credits
  • 300 results = 30 credits

​
Header Parameters

​
x-api-key
string
required

Your API key

​
Body Parameters

​
total_results
integer
default:"10"

Number of conversations to retrieve

​
country
string
default:"FR"

Country code for proxy selection. Available: (US,UK,FR)

​
login_token
string
required

LinkedIn authentication cookie obtained from the login/verify process

​
Response

​
status
string

Request status (success/error)

​
data
object
{
  "status": "success",
  "data": {
    "total_results": 1,
    "conversations": [
      {
        "conversation_id": "urn:li:conversation:123456789",
        "participant": {
          "name": "John Doe",
          "headline": "Software Engineer at Tech Company",
          "profile_url": "https://www.linkedin.com/in/johndoe/"
        },
        "last_message": {
          "text": "Thanks for connecting!",
          "time": 1679529600000
        },
        "unread": 1,
        "type": "normal"
      }
    ]
  }
}

​
Notes

  • Conversations are sorted by most recent messages first
  • The timestamp in last_message.time is in milliseconds since epoch
  • The unread count indicates how many messages in the conversation haven’t been read
  • Each conversation includes details about the other participant only (not yourself)
  • The type field indicates if it’s a normal conversation or a special type
  • The maximum number of conversations that can be retrieved in a single request is limited