Skip to main content

Member Relationships

A relationship is a named link between two members in the same workspace. Roles are built in. You pick one; you do not invent new types.

Being someone's parent, spouse, sibling, caregiver, emergency contact, or next of kin does not open their records. Chart access is granted only when you record a legal guardian, healthcare agent, treating doctor, or the organization's primary contact.

What each role does​

Role of the related personWhat it meansHow manySpecial access
Legal guardianCourt-appointed guardian, or parent/person with parental responsibility for a minorManyCan read this member's records and the files on their chart
Healthcare agentHealthcare power of attorney or health proxyManyCan read this member's records and the files on their chart
DoctorTreating clinician for this memberManyCan read this member's records and the files on their chart
Primary contactStaff member who owns this person inside the organizationOne per memberCan read this member's records and the files on their chart
Parent, Child, Sibling, SpouseFamilySpouse is one; others manyListed only — no record access
CaregiverProvides care at homeManyListed only — no record access
Emergency contactOutreach in an emergencyManyListed only — no record access
Next of kinDesignated next of kin for notificationOne per memberListed only — no record access
Contact ownerStaff member who owns this person's record in your CRM (for example the HubSpot contact owner)One per memberListed only — no record access
EmployerThe Business this person works atManyListed only — no record access

Creating a legal-guardian, healthcare-agent, doctor, or primary-contact relationship grants the related member read access to that member's chart records. You need permission to administer members to add or remove those roles; every other role (family, outreach, contact owner and employer) only needs permission to edit members. Removing the relationship removes that chart access. It does not change file-sharing settings or roles.

Which files this opens. Only the documents filed to that member's chart — not everything the person who uploaded them has ever filed. A document that is not attached to anyone's chart stays private. Filing a document to someone's chart is itself a disclosure, so it needs the same permission as recording one of these four roles; taking it off a chart only needs permission to edit files.

For a child, record the parent as Parent and as Legal guardian if they should see the child's records.

A spouse, caregiver, or emergency contact who also has legal authority should be recorded as Legal guardian or Healthcare agent as well.

Businesses​

Employer is the only role that links a person to a Business. When you choose it, the picker shows Businesses, not people. The Business's own Relationships tab lists the same people as Employee.

Every other role links two people. A Business cannot be a parent, a doctor, an emergency contact, or any other role. Only a regular member can have an employer. A test member, an anonymous member, or an Agent cannot.

How to add one​

  1. Open the member.
  2. Open the Relationships tab.
  3. Choose the related person's role (for example Doctor or Legal guardian).
  4. Pick the related member and click Add.

You need permission to edit members for family, outreach, contact owner and employer roles, and permission to administer members to add or remove chart-read roles. The same tab lists incoming and outgoing links, so a doctor's page also shows their patients, and a contact owner's page shows the contacts they own as Owns contact.

Use relationships in filters and conditions​

  • Member filters: add Has relationship from the Relationships group. Pick the role the other member plays — Primary contact finds members who have a primary contact; Primary contact for finds the members who are someone's primary contact. Employer finds people who are linked to a Business. Is not empty finds members with any relationship.
  • CEL conditions (Task edges, Journey steps, Event Rules, Abilities): member.relationships is a list of {kind, related_member_id}. For example member.relationships.exists(r, r.kind == 'emergency_contact'), or size(member.relationships) > 0 for any relationship. Message templates cannot read member.relationships.
  • Related Members (CEL conditions and message templates): member.related.contact_owner, member.related.primary_contact and member.related.doctor give the related Member's name, email, phone and fields — for example {{ member.related.contact_owner.first_name }}. Other roles cannot be read. See Related Members in the CEL guide.

Removed relationships never match.

CLI​

yarn gr members relationships kinds
yarn gr members relationships list --member-id 12 -w $UUID
yarn gr members relationships create --member-id 12 --related-member-id 34 --related-role legal_guardian -w $UUID --allow-write
yarn gr members relationships archive --member-id 12 --id 56 -w $UUID --allow-write