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.
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.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Groovin","colors":{"primary":"#f37546","light":"#d64baf","dark":"#040404"},"logo":{"light":"https://media.brand.dev/8a452a89-9e16-46a4-97fb-c1afa22cee62.svg","dark":"https://media.brand.dev/8a452a89-9e16-46a4-97fb-c1afa22cee62.svg"},"favicon":"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png","api":{"playground":{"display":"interactive","proxy":false}},"navbar":{"links":[],"primary":{"type":"button","label":"Get Started","href":"https://groovin.ai"}},"fonts":{"heading":{"family":"Inter","weight":900},"body":{"family":"Inter","weight":400}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"groovin","hasAudioNarration":false,"actualSubdomain":"groovin","customDomains":["docs.groovin.ai"],"gitSource":{"type":"github","owner":"groovin-ai","repo":"groovin-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6aec7b9eb09eb89604ce751a"},"chroma":{"collectionId":"8246c8fd-0dd2-48d9-bcf0-bbf6abdc2cf3","liveDeploymentHistoryId":"6aecaa4b8029e5fb8e3f0b21","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecaa4b8029e5fb8e3f0b21"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeceeecd9f359d347c57fe3","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"MCP and API","count":42},{"language":"default","tag":"REST API","count":19},{"language":"default","tag":"MCP Server","count":9},{"language":"default","tag":"LinkedIn","count":8},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"CRM contacts and companies","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Safety and limits","count":5},{"language":"default","tag":"MCP","count":5},{"language":"default","tag":"Get Started","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/api/list-relations","slug":"/reference/api/list-relations","pageMetadata":{"title":"List your LinkedIn connections","description":"See your 1st-degree connections, newest first. Filter by date or name.","openapi":"reference/openapi.json POST /linkedin/relations","href":"/reference/api/list-relations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"See your 1st-degree connections, newest first. Filter by date or name.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`This reads LinkedIn live through your account. Keep the prefilled `,_jsx(_components.code,{children:`limit`}),`: without it, Groovin reads your whole network, at one LinkedIn request per 1,000 connections.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-this-call-does`,children:`What this call does`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LinkedIn`})}),_jsxs(_components.td,{children:[`Live read: 1 request per 1,000 connections, stopping early with `,_jsx(_components.code,{children:`limit`}),` or `,_jsx(_components.code,{children:`connected_after`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your CRM`})}),_jsx(_components.td,{children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Also`})}),_jsx(_components.td,{children:`An empty request reads your whole network`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Repeating it`})}),_jsx(_components.td,{children:`Each repeat costs LinkedIn requests: wait before trying again.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`good-to-know`,children:`Good to know`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsxs(_components.li,{children:[`To follow new connections, use the `,_jsxs(_components.a,{href:`/reference/webhooks/relation-created`,children:[_jsx(_components.code,{children:`linkedin.relation.created`}),` webhook`]}),` rather than polling.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Your AI assistant reaches the same action through the MCP tool `,_jsx(_components.code,{children:`list_linkedin_relations`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List your LinkedIn connections","description":"See your 1st-degree connections, newest first. Filter by date or name.","openapi":"reference/openapi.json POST /linkedin/relations","href":"/reference/api/list-relations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What this call does","slug":"what-this-call-does","depth":2,"children":[]},{"title":"Good to know","slug":"good-to-know","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"list_linkedin_relations","summary":"List your LinkedIn connections","description":"See your 1st-degree connections, newest first. Filter by date or name.","tags":["LinkedIn"],"requestBody":"c1ea8824-0798-462c-8065-1f88e35d4818","responses":{"200":"ebd98da6-e514-4904-a8d1-e6133136d42c","400":"a99b95e7-fe90-426a-bd06-87f3a9a5c096","401":"394e63f4-ace6-495f-81c7-0a1e6d2d003c","403":"5566cb25-e2e1-471e-be24-008ba1d46b08","404":"9698676f-b8f1-4ba2-a90b-315a69be70e3","429":"fa9a3768-298b-40a2-8aef-5d36d3a30ed0","500":"bdb010ca-dce2-4f78-83f4-80909333f0cb","502":"4017995c-aadf-4f35-97a0-7487f16a2acb"},"method":"post","type":"path","servers":["a0487c26-68da-4177-9726-8d6498ae07a4"],"security":["3ed4ef1e-3328-437b-84d1-83f04b15cfea"],"path":"/linkedin/relations","baseUrlOptions":["https://api.groovin.ai/functions/v1/api/v1"],"title":"List your LinkedIn connections","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"org_linkedin_account_id":{"type":"integer","description":"Leave this out to use your own LinkedIn account. Another person's account is refused with a 403.","uniqueKey":"org_linkedin_account_id","typeLabel":"integer"},"connected_after":{"type":"string","description":"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.","uniqueKey":"connected_after","typeLabel":"string"},"connected_before":{"type":"string","description":"Only connections made up to this date.","uniqueKey":"connected_before","typeLabel":"string"},"name_filter":{"type":"string","description":"Search by name. LinkedIn runs the search, and it is still a live request.","uniqueKey":"name_filter","typeLabel":"string"},"limit":{"type":"integer","description":"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.","default":10,"uniqueKey":"limit","typeLabel":"integer"}},"required":[],"uniqueKey":"","typeLabel":"object"},"examples":{"placeholder":{"title":"placeholder","value":{"limit":10}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ebd98da6-e514-4904-a8d1-e6133136d42c":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","description":"Your LinkedIn connections, newest first.","required":["org_linkedin_account_id","total_matched","returned","truncated","linkedin_requests","relations"],"properties":{"org_linkedin_account_id":{"type":"integer","description":"Groovin's id for the LinkedIn account this answer is about.","isRequired":true,"uniqueKey":"org_linkedin_account_id","typeLabel":"integer"},"total_matched":{"type":"integer","description":"Matches among the pages actually read. When `truncated` is `true`, the real total can be higher.","isRequired":true,"uniqueKey":"total_matched","typeLabel":"integer"},"returned":{"type":"integer","description":"Connections in this answer.","isRequired":true,"uniqueKey":"returned","typeLabel":"integer"},"truncated":{"type":"boolean","description":"`true` when more matches may exist than were returned.","isRequired":true,"uniqueKey":"truncated","typeLabel":"boolean"},"linkedin_requests":{"type":"integer","description":"Live LinkedIn requests this call made.","isRequired":true,"uniqueKey":"linkedin_requests","typeLabel":"integer"},"relations":{"type":"array","items":{"type":"object","description":"One of your LinkedIn connections.","required":["linkedin_profile_id","slug","name","first_name","last_name","headline","profile_url","picture_url","member_urn","connection_urn","created_at","connected_at","already_paired_in_groovin"],"properties":{"linkedin_profile_id":{"type":"string","description":"LinkedIn profile id, the `ACoAA…` identifier of a person.","isRequired":true,"uniqueKey":"relations.items.[INDEX].linkedin_profile_id","typeLabel":"string"},"slug":{"oneOf":[{"type":"string","description":"The public part of the person's LinkedIn URL, as in `linkedin.com/in/\u003cslug>`.","isRequired":true,"uniqueKey":"relations.items.[INDEX].slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"The public part of the person's LinkedIn URL, as in `linkedin.com/in/\u003cslug>`.","isRequired":true,"uniqueKey":"relations.items.[INDEX].slug.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].slug","typeLabel":"string | null"},"name":{"type":"string","description":"Their name.","isRequired":true,"uniqueKey":"relations.items.[INDEX].name","typeLabel":"string"},"first_name":{"oneOf":[{"type":"string","description":"First name.","isRequired":true,"uniqueKey":"relations.items.[INDEX].first_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name.","isRequired":true,"uniqueKey":"relations.items.[INDEX].first_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","description":"Last name.","isRequired":true,"uniqueKey":"relations.items.[INDEX].last_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name.","isRequired":true,"uniqueKey":"relations.items.[INDEX].last_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].last_name","typeLabel":"string | null"},"headline":{"oneOf":[{"type":"string","description":"Their LinkedIn headline.","isRequired":true,"uniqueKey":"relations.items.[INDEX].headline.oneOf.0","typeLabel":"string"},{"type":"null","description":"Their LinkedIn headline.","isRequired":true,"uniqueKey":"relations.items.[INDEX].headline.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].headline","typeLabel":"string | null"},"profile_url":{"oneOf":[{"type":"string","description":"Their LinkedIn profile URL.","isRequired":true,"uniqueKey":"relations.items.[INDEX].profile_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Their LinkedIn profile URL.","isRequired":true,"uniqueKey":"relations.items.[INDEX].profile_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].profile_url","typeLabel":"string | null"},"picture_url":{"oneOf":[{"type":"string","description":"Their profile picture URL.","isRequired":true,"uniqueKey":"relations.items.[INDEX].picture_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Their profile picture URL.","isRequired":true,"uniqueKey":"relations.items.[INDEX].picture_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].picture_url","typeLabel":"string | null"},"member_urn":{"oneOf":[{"type":"string","description":"LinkedIn's internal reference for this person. Use `linkedin_profile_id` instead.","isRequired":true,"uniqueKey":"relations.items.[INDEX].member_urn.oneOf.0","typeLabel":"string"},{"type":"null","description":"LinkedIn's internal reference for this person. Use `linkedin_profile_id` instead.","isRequired":true,"uniqueKey":"relations.items.[INDEX].member_urn.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].member_urn","typeLabel":"string | null"},"connection_urn":{"oneOf":[{"type":"string","description":"LinkedIn's internal reference for this connection.","isRequired":true,"uniqueKey":"relations.items.[INDEX].connection_urn.oneOf.0","typeLabel":"string"},{"type":"null","description":"LinkedIn's internal reference for this connection.","isRequired":true,"uniqueKey":"relations.items.[INDEX].connection_urn.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].connection_urn","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"integer","description":"When you connected, in milliseconds since 1970. `connected_at` is the same date, easier to read.","isRequired":true,"uniqueKey":"relations.items.[INDEX].created_at.oneOf.0","typeLabel":"integer"},{"type":"null","description":"When you connected, in milliseconds since 1970. `connected_at` is the same date, easier to read.","isRequired":true,"uniqueKey":"relations.items.[INDEX].created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].created_at","typeLabel":"integer | null"},"connected_at":{"oneOf":[{"type":"string","description":"When you connected (ISO 8601).","isRequired":true,"uniqueKey":"relations.items.[INDEX].connected_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When you connected (ISO 8601).","isRequired":true,"uniqueKey":"relations.items.[INDEX].connected_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"relations.items.[INDEX].connected_at","typeLabel":"string | null"},"already_paired_in_groovin":{"type":"boolean","description":"`true` when Groovin already links this person to a CRM contact. A quick Groovin check, not a live CRM search.","isRequired":true,"uniqueKey":"relations.items.[INDEX].already_paired_in_groovin","typeLabel":"boolean"},"is_crm_contact_creation_blocked":{"const":true,"description":"Only present, as `true`, when you blocked this person from CRM contact creation in Groovin. `crm/contacts` does not enforce the block, so check it yourself before creating.","uniqueKey":"relations.items.[INDEX].is_crm_contact_creation_blocked","typeLabel":"any"}},"uniqueKey":"relations.items.[INDEX]","typeLabel":"object"},"description":"The connections.","isRequired":true,"uniqueKey":"relations","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"org_linkedin_account_id":4821,"total_matched":10,"returned":1,"truncated":true,"linkedin_requests":1,"relations":[{"linkedin_profile_id":"ACoAAExampleLinkedinProfileId","slug":"john-smith","name":"John Smith","first_name":"John","last_name":"Smith","headline":"Founder at Example Co","profile_url":"https://www.linkedin.com/in/john-smith","picture_url":null,"member_urn":null,"connection_urn":null,"created_at":1762070400000,"connected_at":"2025-11-02T08:00:00.000Z","already_paired_in_groovin":false}]},"examples":{"Example":{"title":"Example","value":{"org_linkedin_account_id":4821,"total_matched":10,"returned":1,"truncated":true,"linkedin_requests":1,"relations":[{"linkedin_profile_id":"ACoAAExampleLinkedinProfileId","slug":"john-smith","name":"John Smith","first_name":"John","last_name":"Smith","headline":"Founder at Example Co","profile_url":"https://www.linkedin.com/in/john-smith","picture_url":null,"member_urn":null,"connection_urn":null,"created_at":1762070400000,"connected_at":"2025-11-02T08:00:00.000Z","already_paired_in_groovin":false}]}}},"exampleType":"examples"}},"exampleType":"examples"},"a99b95e7-fe90-426a-bd06-87f3a9a5c096":{"description":"Something in the request is wrong: `error` says what.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"394e63f4-ace6-495f-81c7-0a1e6d2d003c":{"description":"The API key is missing, wrong or revoked.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5566cb25-e2e1-471e-be24-008ba1d46b08":{"description":"Your account cannot do this: no CRM connected, inactive subscription, Billing admin role, or a teammate's LinkedIn account.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9698676f-b8f1-4ba2-a90b-315a69be70e3":{"description":"What you asked for does not exist, or your LinkedIn account is not connected.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fa9a3768-298b-40a2-8aef-5d36d3a30ed0":{"description":"LinkedIn or your CRM is slowing you down. Wait at least 5 minutes.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"bdb010ca-dce2-4f78-83f4-80909333f0cb":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4017995c-aadf-4f35-97a0-7487f16a2acb":{"description":"LinkedIn or your CRM could not be reached or gave an unreadable answer.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3ed4ef1e-3328-437b-84d1-83f04b15cfea":{"apiKey":{"type":"http","scheme":"bearer","description":"Your Groovin API key (`gv_live_…`), created in the extension under Settings, MCP and API.","scopes":[],"schemeName":"apiKey"}}},"servers":{"a0487c26-68da-4177-9726-8d6498ae07a4":{"url":"https://api.groovin.ai/functions/v1/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your Groovin API key (`gv_live_…`), created in the extension under Settings, MCP and API.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Groovin API key (`gv_live_…`), created in the extension under Settings, MCP and API.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"reference/openapi.json"},"subdomain":"groovin","siteName":"Groovin","title":"List your LinkedIn connections - Groovin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T19:46:01.598Z","originalFileLocation":"reference/api/list-relations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"See your 1st-degree connections, newest first. Filter by date or name.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Groovin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"List your LinkedIn connections - Groovin\">\u003cmeta data-mint-head property=\"og:description\" content=\"See your 1st-degree connections, newest first. Filter by date or name.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Groovin\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.groovin.ai/reference/api/list-relations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://groovin.mintlify.app/_mintlify/api/og/v2?division=LinkedIn\u0026amp;title=List+your+LinkedIn+connections\u0026amp;description=See+your+1st-degree+connections%2C+newest+first.+Filter+by+date+or+name.\u0026amp;theme=2fb27e555653d3152d4427c9\u0026amp;signature=85d967d4d0319078c46f96321aae9bc131451556c9ad789e8f56a6e62bba7c3f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List your LinkedIn connections - Groovin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"See your 1st-degree connections, newest first. Filter by date or name.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://groovin.mintlify.app/_mintlify/api/og/v2?division=LinkedIn\u0026amp;title=List+your+LinkedIn+connections\u0026amp;description=See+your+1st-degree+connections%2C+newest+first.+Filter+by+date+or+name.\u0026amp;theme=2fb27e555653d3152d4427c9\u0026amp;signature=85d967d4d0319078c46f96321aae9bc131451556c9ad789e8f56a6e62bba7c3f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/groovin/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Groovin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#f37546\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.groovin.ai/reference/api/list-relations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/api/list-relations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.groovin.ai/#organization\",\"name\":\"Groovin\",\"url\":\"https://docs.groovin.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://media.brand.dev/8a452a89-9e16-46a4-97fb-c1afa22cee62.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.groovin.ai#website\",\"name\":\"Groovin\",\"url\":\"https://docs.groovin.ai\",\"publisher\":{\"@id\":\"https://docs.groovin.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.groovin.ai/reference/api/list-relations#webpage\",\"url\":\"https://docs.groovin.ai/reference/api/list-relations\",\"name\":\"List your LinkedIn connections\",\"description\":\"See your 1st-degree connections, newest first. Filter by date or name.\",\"dateModified\":\"2026-11-05T19:46:01.598Z\",\"isPartOf\":{\"@id\":\"https://docs.groovin.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.groovin.ai/reference/api/list-relations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.groovin.ai/reference/api/list-relations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.groovin.ai/reference/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"LinkedIn\",\"item\":\"https://docs.groovin.ai/reference/api/list-conversation-attendees\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List your LinkedIn connections\",\"item\":\"https://docs.groovin.ai/reference/api/list-relations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.groovin.ai/reference/api/list-relations#apireference\",\"headline\":\"List your LinkedIn connections\",\"name\":\"List your LinkedIn connections\",\"description\":\"See your 1st-degree connections, newest first. Filter by date or name.\",\"url\":\"https://docs.groovin.ai/reference/api/list-relations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.groovin.ai/reference/api/list-relations#webpage\"},\"dateModified\":\"2026-11-05T19:46:01.598Z\",\"publisher\":{\"@id\":\"https://docs.groovin.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.groovin.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Groovin\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Groovin","nav":{"global":null,"tabs":[{"tab":"Getting started","icon":"home","hidden":true},{"tab":"MCP Server","icon":"code","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"MCP and API","groups":[{"group":"Get started","pages":[{"title":"MCP and API","href":"/reference/introduction"},{"title":"Quickstart","href":"/reference/quickstart"},{"title":"Use these docs with your AI assistant","href":"/reference/ai-assistants"},{"title":"Authentication","href":"/reference/authentication"},{"title":"Identifiers","href":"/reference/identifiers"}]},{"group":"Safety and limits","pages":[{"title":"What each call really does","mode":"wide","href":"/reference/side-effects"},{"title":"Limits and quotas","href":"/reference/limits"},{"title":"Errors","href":"/reference/errors"},{"title":"Long lists","href":"/reference/pagination"},{"title":"Changes and compatibility","href":"/reference/versioning"}]},{"group":"REST API","pages":[{"title":"REST API","href":"/reference/api/overview"},{"group":"LinkedIn","pages":[{"title":"List the people in your conversations","openapi":"reference/openapi.json POST /linkedin/conversation-attendees","href":"/reference/api/list-conversation-attendees"},{"title":"Read a conversation","openapi":"reference/openapi.json POST /linkedin/chat-messages","href":"/reference/api/get-chat-messages"},{"title":"Mark a conversation as read or unread","openapi":"reference/openapi.json POST /linkedin/chat-read-status","href":"/reference/api/set-chat-read-status"},{"title":"Get a LinkedIn profile","openapi":"reference/openapi.json POST /linkedin/profile","href":"/reference/api/get-profile"},{"title":"Send a LinkedIn message","openapi":"reference/openapi.json POST /linkedin/messages","href":"/reference/api/send-message"},{"title":"Send a LinkedIn invitation","description":"Send one connection invitation from your account, with an optional note.","openapi":"reference/openapi.json POST /linkedin/invitations","href":"/reference/api/send-invitation"},{"title":"List your LinkedIn connections","openapi":"reference/openapi.json POST /linkedin/relations","href":"/reference/api/list-relations"},{"title":"List your pending invitations","description":"See the invitations waiting for an answer: the ones you sent, the ones you received, or both.","openapi":"reference/openapi.json POST /linkedin/pending-invitations","href":"/reference/api/list-pending-invitations"}]},{"group":"CRM contacts and companies","pages":[{"title":"Check who is already in your CRM","openapi":"reference/openapi.json POST /crm/contacts/lookup","href":"/reference/api/lookup-contacts"},{"title":"Create CRM contacts","openapi":"reference/openapi.json POST /crm/contacts","href":"/reference/api/create-contacts"},{"title":"List your synced contacts","openapi":"reference/openapi.json POST /crm/contacts/synced","href":"/reference/api/list-synced-contacts"},{"title":"Turn message sync on or off","openapi":"reference/openapi.json POST /crm/contacts/sync-toggle","href":"/reference/api/toggle-sync"},{"title":"Find missing LinkedIn URLs","openapi":"reference/openapi.json POST /crm/contacts/find-linkedin-url","href":"/reference/api/find-linkedin-urls"},{"title":"Find missing company domains","openapi":"reference/openapi.json POST /crm/companies/find-domains","href":"/reference/api/find-company-domains"}]},{"group":"LinkedIn connections import","pages":[{"title":"Start a connections import","openapi":"reference/openapi.json POST /crm/connections-import/start","href":"/reference/api/start-connections-import"},{"title":"Check a connections import","openapi":"reference/openapi.json POST /crm/connections-import/status","href":"/reference/api/get-connections-import"},{"title":"Stop a connections import","openapi":"reference/openapi.json POST /crm/connections-import/cancel","href":"/reference/api/cancel-connections-import"}]},{"title":"Data models","href":"/reference/data-models"}]},{"group":"MCP","pages":[{"title":"Connect your AI tool","href":"/reference/mcp/connect"},{"title":"MCP tools","href":"/reference/mcp/tools"},{"title":"Browser sign-in","href":"/reference/mcp/oauth"},{"title":"Protocol details","href":"/reference/mcp/protocol"},{"title":"MCP errors","href":"/reference/mcp/errors"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","href":"/reference/webhooks/overview"},{"title":"New LinkedIn message","openapi":"reference/openapi.json webhook linkedin.message.created","href":"/reference/webhooks/message-created"},{"title":"New LinkedIn connection","openapi":"reference/openapi.json webhook linkedin.relation.created","href":"/reference/webhooks/relation-created"},{"title":"The crm_contact block","href":"/reference/webhooks/crm-contact"},{"title":"Verify signatures","href":"/reference/webhooks/verify-signatures"},{"title":"Delivery and retries","href":"/reference/webhooks/delivery"},{"title":"Set up a webhook","href":"/reference/webhooks/manage"}]},{"group":"Help","pages":[{"title":"Known issues and troubleshooting","href":"/reference/known-issues"}]}]}]},"basePath":"","title":"List your LinkedIn connections - Groovin","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-B5zPa4Vr.js","utils-CVjrr8Yd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DTgURWzl.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DxTHtkdZ.js","snippetPresets-Cx47o5Vx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CYZot51e.js","ApiExamples-4Fr6y9N_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dq2ElbEk.js","shallow-BfYl9r69.js","getApiPlaygroundDisplay-Ch3xc7i1.js","CodeSnippet-BsBxuJ1v.js","CodeSnippets-CetzeDL8.js","getPastedJson-BxPKFSJx.js","icon-o0J1Ochb.js","MethodPill-Du3usO5m.js","DuplicateIcon-DJypyMzl.js","createIcon-YMA6N8KJ.js","DynamicMarkdown-CWvhfcZc.js","SectionHeading-BdLVaXCd.js","axios-vUo_bRtp.js","Markdown-C4Ez6OeV.js","clsx-DptzKFCt.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Dt1IougW.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CZ6Wt2Vb.js"]}