Skip to main content
POST
List your LinkedIn connections
This reads LinkedIn live through your account. Keep the prefilled limit: without it, Groovin reads your whole network, at one LinkedIn request per 1,000 connections.

What this call does

Good to know

  • After a first full read, only read the newest page, a few times a day at most, at irregular times. A fixed schedule looks like automation to LinkedIn.
  • To follow new connections, use the linkedin.relation.created webhook rather than polling.
Your AI assistant reaches the same action through the MCP tool list_linkedin_relations.

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.

connected_after
string

Only connections made since this date, such as "2026-10-01". The cheapest way to get what is new: reading stops as soon as it gets past that date.

connected_before
string

Only connections made up to this date.

name_filter
string

Search by name. LinkedIn runs the search, and it is still a live request.

limit
integer
default:10

The most connections to return. Reading stops once this many are found, usually after one request. The playground fills this in for you. The API itself has no default: without limit, you get everything.

Response

Success.

Your LinkedIn connections, newest first.

org_linkedin_account_id
integer
required

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

total_matched
integer
required

Matches among the pages actually read. When truncated is true, the real total can be higher.

returned
integer
required

Connections in this answer.

truncated
boolean
required

true when more matches may exist than were returned.

linkedin_requests
integer
required

Live LinkedIn requests this call made.

relations
object[]
required

The connections.