Skip to content
Docs menu

Link people and companies in Venom People

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.

View .md

Open a person in Venom People: 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 and never shown to a colleague, even for a person you shared with the org.

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, 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.