A Connected Person is an account from a different organization linked to an account in this organization.
| Property | Value |
|---|---|
| Product | People (pco.people, API version 2026-10-05) |
| Resource type | ConnectedPerson |
| TypeScript | People.ConnectedPerson, attributes People.ConnectedPersonAttributes, schema People.ConnectedPersonSchema |
| Planning Center path | /people/v2/people/{person_id}/connected_people |
| Planning Center docs | ConnectedPerson |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.people.people.id(personId).connected_people |
Collection | No |
From a collection, .id(connectedPersonId) addresses one ConnectedPerson: pco.people.people.id(personId).connected_people.id(connectedPersonId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On People.ConnectedPersonAttributes. Every resource also has id and type ('ConnectedPerson') next to its attributes.
| Name | Type | Description |
|---|---|---|
first_name |
string | null |
|
gender |
string | null |
|
given_name |
string | null |
|
last_name |
string | null |
|
middle_name |
string | null |
|
nickname |
string | null |
|
organization_id |
string | null |
|
organization_name |
string | null |
Relationships and includes
Planning Center documents no includes for this resource.
| Relationship | Type | To | Includable |
|---|---|---|---|
organization |
To one | Organization | No |
Querying
No documented where fields.
No documented order fields.
Edges
This resource has no documented edges.
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { People } from '@mackenly/planningcenterkit';
const personId = '1'; // Person id
const page = await pco.people.people.id(personId).connected_people.perPage(25).list();
const items: People.ConnectedPerson[] = page.data;