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 '{
  "login_token": "<string>",
  "country": "<string>",
  "total_results": 123,
  "category": "<string>",
  "next_cursor": "<string>"
}'
{
  "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="
  }
}

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
{
  "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="
  }
}