---
title: "Person (API)"
description: "The Person resource in Planning Center API: how to reach it, its attributes, and what you can query and write."
---

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

# Person (API)

| Property | Value |
| --- | --- |
| Product | [API](/reference/api/) (`pco.api`, API version `2026-09-24`) |
| Resource type | `Person` |
| TypeScript | `Api.Person`, attributes `Api.PersonAttributes`, schema `Api.PersonSchema` |
| Planning Center path | `/api/v2/personal_access_tokens/{personal_access_token_id}/person` |
| Planning Center docs | [Person](https://api.planningcenteronline.com/docs/apps/api/versions/2026-09-24/vertices/person) |

## How to reach it

| Client path | Returns | Filters | Create |
| --- | --- | --- | --- |
| `pco.api.personal_access_tokens.id(personalAccessTokenId).person` | Collection |  | No |

From a collection, `.id(personId)` addresses one Person: `pco.api.personal_access_tokens.id(personalAccessTokenId).person.id(personId)`. Collections support [`where`, `include`, `order`, and pagination](/guides/querying/); single resources have `get()`.

## Attributes

On `Api.PersonAttributes`. Every resource also has `id` and `type` (`'Person'`) next to its attributes.

| Name | Type | Description |
| --- | --- | --- |
| `avatar_url` | `string \| null` |  |
| `first_name` | `string \| null` |  |
| `last_name` | `string \| null` |  |

## 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

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

const personalAccessTokenId = '1'; // PersonalAccessToken id

const page = await pco.api.personal_access_tokens.id(personalAccessTokenId).person.perPage(25).list();
const items: Api.Person[] = page.data;
```

Source: https://planningcenterkit.mackenly.com/reference/api/person/index.mdx
