---
title: "PersonApp (People)"
description: "A Person App is the relationship between a Person and an App."
---

> Documentation Index
> Fetch the complete documentation index at: https://planningcenterkit.mackenly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PersonApp (People)

A Person App is the relationship between a Person and an App.

| Property | Value |
| --- | --- |
| Product | [People](/reference/people/) (`pco.people`, API version `2026-10-05`) |
| Resource type | `PersonApp` |
| TypeScript | `People.PersonApp`, attributes `People.PersonAppAttributes`, schema `People.PersonAppSchema` |
| Planning Center path | `/people/v2/people/{person_id}/person_apps` |
| Planning Center docs | [PersonApp](https://api.planningcenteronline.com/docs/apps/people/versions/2026-10-05/vertices/person_app) |

## How to reach it

| Client path | Returns | Filters | Create |
| --- | --- | --- | --- |
| `pco.people.people.id(personId).person_apps` | Collection |  | Yes |

From a collection, `.id(personAppId)` addresses one PersonApp: `pco.people.people.id(personId).person_apps.id(personAppId)`. Collections support [`where`, `include`, `order`, and pagination](/guides/querying/); single resources have `get()`.

## Attributes

On `People.PersonAppAttributes`. Every resource also has `id` and `type` (`'PersonApp'`) next to its attributes.

| Name | Type | Description |
| --- | --- | --- |
| `allow_pco_login` | `boolean \| null` |  |
| `people_permissions` | `string \| null` | Possible values: `no_access`, `viewer`, or `editor` |

## Relationships and includes

Side-load with `include()` (or `get({ include })`) and read with `related(resource, name)`: `app`.

| Relationship | Type | To | Includable |
| --- | --- | --- | --- |
| `app` | To one | [App](/reference/people/app/) | Yes |
| `person` | To one | [Person](/reference/people/person/) | No |

## Querying

No documented `where` fields.

No documented `order` fields.

## Edges

Follow these from one PersonApp, `ref = pco.people.people.id(personId).person_apps.id(personAppId)`:

| Edge | Leads to | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `ref.app` | [App](/reference/people/app/) | Collection |  | No |

## Writing

| Property | Value |
| --- | --- |
| Create | Yes, `create()` on `person_apps` on [Person](/reference/people/person/) |
| Update | No |
| Delete | No |

### Create attributes

Typed as `People.PersonAppSchema['create']`.

| Attribute | Type |
| --- | --- |
| `app_id` | `string` |
| `app_name` | `unknown` |
| `email_template_id` | `string` |

See [Writing data](/guides/writing-data/).

## Example

```ts
import type { People } from '@mackenly/planningcenterkit';

const personId = '1'; // Person id

const page = await pco.people.people.id(personId).person_apps.perPage(25).list();
const items: People.PersonApp[] = page.data;
```

Source: https://planningcenterkit.mackenly.com/reference/people/person-app/index.mdx
