---
title: "API reference"
description: "Planning Center API in Planning Center Kit: OAuth applications, personal access tokens, and connected applications."
---

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

# API reference

OAuth applications, personal access tokens, and connected applications.

| Property | Value |
| --- | --- |
| Client property | `pco.api` |
| Subpath import | `import { createApiClient } from '@mackenly/planningcenterkit/api'` |
| Types namespace | `Api` |
| Base path | `/api/v2` |
| Pinned API version | `2026-09-24` |
| Resource types | 7 |
| Planning Center docs | [Planning Center API API](https://api.planningcenteronline.com/docs/apps/api/versions/2026-09-24) |

Each product client sends `X-PCO-API-Version: 2026-09-24`, the version these types were generated from. Override it with `new PlanningCenter({ auth, versions: { api: '...' } })`; the types won't follow. See [Products](/guides/products/).

```ts
import { createApiClient } from '@mackenly/planningcenterkit/api';

const api = createApiClient({ auth: { applicationId: process.env.PCO_APP_ID!, secret: process.env.PCO_SECRET! } });
const { data: root } = await api.get(); // /api/v2
```

## Root collections

Properties on `pco.api`, named after their URL. `pco.api.get()` fetches the product root (`/api/v2`), and `pco.api.edge(name)` follows any root edge by name.

| Client path | Resource | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `pco.api.connected_applications` | [ConnectedApplication](/reference/api/connected-application/) | Collection |  | No |
| `pco.api.oauth_applications` | [OauthApplication](/reference/api/oauth-application/) | Collection |  | No |
| `pco.api.personal_access_tokens` | [PersonalAccessToken](/reference/api/personal-access-token/) | Collection | `accessible` | No |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [ConnectedApplication](/reference/api/connected-application/) | `Api.ConnectedApplication` |  |
| [ConnectedApplicationPerson](/reference/api/connected-application-person/) | `Api.ConnectedApplicationPerson` |  |
| [OauthApplication](/reference/api/oauth-application/) | `Api.OauthApplication` |  |
| [OauthApplicationMau](/reference/api/oauth-application-mau/) | `Api.OauthApplicationMau` | Monthly Active Users for an Oauth Application. |
| [Organization](/reference/api/organization/) | `Api.Organization` |  |
| [Person](/reference/api/person/) | `Api.Person` |  |
| [PersonalAccessToken](/reference/api/personal-access-token/) | `Api.PersonalAccessToken` |  |

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