---
title: Link people and companies in Venom People
description: Link one of your people to another with a kind and a date, record where someone has worked, and accept suggested links, all private to you and shown from both sides.
section: cloud
order: 165
audience: [user, agent]
sources: [services/nodejs-cloud/components/people/Connections.tsx, services/nodejs-cloud/components/people/links-actions.ts, services/nodejs-cloud/lib/people/links.ts, services/nodejs-cloud/lib/people/links-model.ts, services/nodejs-cloud/lib/people/tools-links.ts, services/nodejs-cloud/lib/people/mcp-links.ts, services/nodejs-cloud/migrations/0176_people_graph.sql, docs/adr/0057-venom-people.md]
features: [cloud.page-people]
---

Open a person in [Venom People](/docs/cloud/people.md): the **Connections** section on their page holds who they are linked to and
where they have worked. Links are your own: they are drawn on [the graph](/docs/cloud/people-graph.md) and never shown to a
colleague, even for a person you shared with the org.

## Link two people

**Link a person** picks a kind, optionally a note and a date, then the other person from your own people:

| Kind | Reads |
|---|---|
| Knows, Colleague, Family, Partner | the same from both sides (one link) |
| Introduced by | Sam *introduced by* Dewi, and Dewi *introduced* Sam |
| Reports to | Sam *reports to* Dewi, and Dewi is *manager of* Sam |
| Investor in | Sam is an *investor in* Dewi, and Dewi is *backed by* Sam |
| Other… | your own words (`mentor`), shown the same from both sides |

Saying the same link again updates its note and date. Remove one with the cross beside it. Only people you know
yourself can be linked, and only to each other.

## Companies and past employers

**Add a company** links the person to a company with a role and dates (leave *To* empty for a current job). A company
you type that does not exist is created. The person's current company stays on their details; these are the others. When
you have [imported your LinkedIn positions](/docs/cloud/people-import.md#linkedin), a person who worked at one of your employers shows
"You both worked at …".

## Suggestions

Venom suggests links and never adds one: **Suggested** lists people at the same company (now or before), people met at
the same event, and the person your *how we met* note names after "introduced by", "via" or "through" (a full name, never a
first name alone). **Add** saves it with the suggested kind; the cross dismisses it for now. Nobody already linked to
them is offered.

## Privacy

A link joins two people you own, so only you read it. A colleague who can see one of your shared people sees their name,
role, company and strength, as before, and none of their links, employers or connection dates. A link to someone else's
person is refused.

## Agents

`people_relationship_create` (`kind`, `note`, `since`, `label`), `people_relationship_list`, `people_relationship_delete`,
`people_suggestion_list`, `people_employment_create`, `people_employment_delete` and `people_employer_set`, over MCP and
REST (`/api/v1/people/{person}/relationships`, `/suggestions`, `/employments`, `/people/employers`). See [the workspace
MCP server](/docs/cloud/people-mcp.md).
