Skip to main content
POST
List the people in your conversations
Safe to try: this reads Groovin’s copy of your LinkedIn inbox. Nothing changes, and no LinkedIn limit applies.

What this call does

Your AI assistant reaches the same action through the MCP tool list_linkedin_conversation_attendees.

Authorizations

Authorization
string
header
required

Your Groovin API key (gv_live_…), created in the extension under Settings, MCP and API.

Body

application/json
org_linkedin_account_id
integer

Leave this out to use your own LinkedIn account. Another person's account is refused with a 403.

include_conversation_metadata
boolean

Add each person's latest chat details, such as conversation_id and unread_count. On by default. Send false for a faster answer, but the order is then not defined.

has_unread_messages
boolean

true keeps people you have unread messages from. false keeps the others. This always adds the chat details.

limit
integer
default:10

Only the N most recent conversations. This always adds the chat details. The playground fills this in for you. The API itself has no default: without limit, you get everything. A large inbox holds thousands of people.

Response

Success.

The people from your LinkedIn conversations.

org_linkedin_account_id
integer
required

Groovin's id for the LinkedIn account this answer is about.

total
integer
required

People matching your filters, before limit.

returned
integer
required

People in this answer.

truncated
boolean
required

true when limit left matching people out.

attendees
object[]
required

Most recent conversation first, unless you sent include_conversation_metadata: false: the order is then not defined.