ToolsLinkedIn Actions
Check LinkedIn connection
Check whether a person is a 1st-degree LinkedIn connection of one seat (connected_account_id) or every connected seat.
Tool: check_linkedin_connection
Silent read - the person is NOT notified.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
person_id | string (slug or UUID) | no | Who to check. One of person_id / linkedin_url is required. |
linkedin_url | string | no | OR act by LinkedIn profile URL - matches the existing person; someone not yet imported is created, enriched (best-effort), and filed into today's misc lead group. A URL pasted into person_id is treated the same way. Alias: profile_url. |
connected_account_id | string (slug or UUID) | no | One seat to check (slug/UUID/alias). Alias: account_id. Default: check ALL connected seats. |
Silent read - the person is not notified (unlike
view_profile).Network distance is per seat:
accounts[]reports each seat separately; top-levelis_connectedis true when ANY checked seat is 1st-degree.⚠️ The provider response in this sample is stubbed (
FIRST_DEGREE); live distances come from the real seat's network.
Sample request — success
{
"person_id": "marco-rossi-0004"
}Sample request — by linkedin url
{
"linkedin_url": "https://www.linkedin.com/in/fresh-prospect-demo"
}