Get Message Inbox

Retrieve LinkedIn messaging conversations

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

login_token · string · required

LinkedIn authentication cookie obtained from the login/verify process

country · string · default: "FR"

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

total_results · integer · default: "10"

Number of conversations to retrieve in this batch

category · string · default: "INBOX"

Category to filter by. Available: (INBOX, INMAIL, JOB, UNREAD)

next_cursor · string

Cursor for pagination (optional - used to get the next batch of results)

Response

status · string

Request status (success/error)

data · object

Show Properties

conversations · array

Show Conversation Object

conversation_id · string

Unique identifier for the conversation

participant · object

Show Participant Properties

name · string

Full name of the other participant

headline · string

Professional headline of the participant

profile_url · string

LinkedIn profile URL of the participant

last_message · object

Show Message Properties

text · string

Content of the last message

time · integer

Timestamp of when the message was delivered

unread · integer

Number of unread messages in the conversation

type · string

Type of conversation (e.g., “normal”)

total_results · integer

Number of conversations returned in this response

next_cursor · string

Cursor for the next batch of results (null if no more results available)

Success Response

{
  "status": "success",
  "data": {
    "conversations": [
      {
        "conversation_id": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAADxnv0oB_dN-NfpvEBlsPU_W1omM-Xu24o,2-M2ZkODhkZjYtZDI1ZC00NzE4LWFiYjgtZDY4YmUxMGMwM2NkXzEwMA==)",
        "participant": {
          "name": "John Bell 🗓️⚡️",
          "headline": "AI that instantly converts and manages pipeline meetings 24/7365. | Believer, Husband, Girl Dad x 3",
          "profile_url": "https://www.linkedin.com/in/michaeltoddbell",
          "profile_picture": "https://media.licdn.com/dms/image/v2/D4E0AEkAmN1PCA6OA/profile-displayphoto-shrink_800_800/B4EZRK07l_GYAg-/0/1736422177433?e=1754524800&v=beta&t=0sRsoyG2kUWaBUOMc99nPnx0CuYV4OFgTEjxLGk03AQ"
        },
        "last_message": {
          "text": "Hey Mike, I'm the founder of LinkupAPI (https://linkupapi.com), an API that allows you to automate any action on LinkedIn. I saw you're working on Scheduler AI – have you thought about adding LinkedIn integration to enhance your offering?",
          "time": 1748629426457,
          "sender": {
            "name": "Titouan Prioux",
            "headline": "Founder of linkup API, the LinkedIn API that automates all your actions on LinkedIn. Easily integrate it into your SaaS/CRM or AI agents",
            "profile_url": "https://www.linkedin.com/in/ACoAADxnv0oB_dN-NfpvEBlsVPU_W1omM-Xu24o",
            "profile_picture": "https://media.licdn.com/dms/image/v2/D4E03AQtezmVn8txQ/profile-displayphoto-shrink_800_800/B4EZXoxaZGHgAc-/0/1743367023080?e=1754524800&v=beta&t=xYaqHyrAogNjcpL3bo8_UlrLzglpJ-pmQHjQSrPPNtM"
          }
        },
        "unread": 0,
        "type": "normal"
      }
    ],
    "total_results": 1,
    "next_cursor": "REVTQ0VORElORyYxNzQ4NjI5NDI2NDU3JjItTTJaa09EaGtaall0WkRJMVpDMBOekU0TFdGaVlqZ3RaRFk0WW1VeE1HTXdNMk5rWHpFd01BPT0="
  }
}