---
title: "Services reference"
description: "Planning Center Services in Planning Center Kit: Service types, plans, items, songs and arrangements, teams, and schedules."
---

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

# Services reference

Service types, plans, items, songs and arrangements, teams, and schedules.

| Property | Value |
| --- | --- |
| Client property | `pco.services` |
| Subpath import | `import { createServicesClient } from '@mackenly/planningcenterkit/services'` |
| Types namespace | `Services` |
| Base path | `/services/v2` |
| Pinned API version | `2018-11-01` |
| Resource types | 65 |
| Planning Center docs | [Planning Center Services API](https://api.planningcenteronline.com/docs/apps/services/versions/2018-11-01) |

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

```ts
import { createServicesClient } from '@mackenly/planningcenterkit/services';

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

## Root collections

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

| Client path | Resource | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `pco.services.attachment_types` | [AttachmentType](/reference/services/attachment-type/) | Collection |  | No |
| `pco.services.chat` | [Chat](/reference/services/chat/) | Collection |  | No |
| `pco.services.email_templates` | [EmailTemplate](/reference/services/email-template/) | Collection |  | Yes |
| `pco.services.folders` | [Folder](/reference/services/folder/) | Collection |  | Yes |
| `pco.services.media` | [Media](/reference/services/media/) | Collection | `archived`, `audio`, `background_audio`, `background_image`, `background_video`, `countdown`, `curriculum`, `document`, `drama`, `image`, `not_archived`, `powerpoint`, `song_video`, `video` | Yes |
| `pco.services.people` | [Person](/reference/services/person/) | Collection |  | No |
| `pco.services.plans` | [Organization](/reference/services/organization/) | Collection |  | No |
| `pco.services.report_templates` | [ReportTemplate](/reference/services/report-template/) | Collection | `matrix`, `people`, `plans`, `without_defaults` | No |
| `pco.services.series` | [Series](/reference/services/series/) | Collection |  | No |
| `pco.services.service_types` | [ServiceType](/reference/services/service-type/) | Collection | `no_parent` | Yes |
| `pco.services.songs` | [Song](/reference/services/song/) | Collection |  | Yes |
| `pco.services.tag_groups` | [TagGroup](/reference/services/tag-group/) | Collection | `arrangement`, `media`, `person`, `song` | No |
| `pco.services.teams` | [Team](/reference/services/team/) | Collection | `editable`, `service_types` | Yes |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [Arrangement](/reference/services/arrangement/) | `Services.Arrangement` | Each arrangement belongs to a song and is a different version of that song. |
| [ArrangementSections](/reference/services/arrangement-sections/) | `Services.ArrangementSections` | Sections of an Arrangement, derived from its chord chart |
| [Attachment](/reference/services/attachment/) | `Services.Attachment` | A file, whether it's stored on Planning Center or linked from another location. |
| [AttachmentActivity](/reference/services/attachment-activity/) | `Services.AttachmentActivity` | Returned from the open attachment action. |
| [AttachmentType](/reference/services/attachment-type/) | `Services.AttachmentType` | Create an Attachment Type for each type of file you might want only specific people to see. |
| [AttachmentTypeGroup](/reference/services/attachment-type-group/) | `Services.AttachmentTypeGroup` |  |
| [Attendance](/reference/services/attendance/) | `Services.Attendance` |  |
| [AvailableSignup](/reference/services/available-signup/) | `Services.AvailableSignup` | Signups that are available. |
| [Blockout](/reference/services/blockout/) | `Services.Blockout` | An object representing a blockout date, and an optional recurrence pattern |
| [BlockoutDate](/reference/services/blockout-date/) | `Services.BlockoutDate` | The actual dates generated by the blockout or its recurrence pattern. |
| [BlockoutException](/reference/services/blockout-exception/) | `Services.BlockoutException` | A single exception for the dates generated from the blockout |
| [BlockoutScheduleConflict](/reference/services/blockout-schedule-conflict/) | `Services.BlockoutScheduleConflict` |  |
| [Chat](/reference/services/chat/) | `Services.Chat` |  |
| [Contributor](/reference/services/contributor/) | `Services.Contributor` | A Contributor Resource |
| [CustomSlide](/reference/services/custom-slide/) | `Services.CustomSlide` | A CustomSlide is used for adding text intended for display on a screen. |
| [Email](/reference/services/email/) | `Services.Email` | A persons email |
| [EmailTemplate](/reference/services/email-template/) | `Services.EmailTemplate` | A EmailTemplate Resource |
| [EmailTemplateRenderedResponse](/reference/services/email-template-rendered-response/) | `Services.EmailTemplateRenderedResponse` | A EmailTemplateRenderedResponse Resource |
| [Folder](/reference/services/folder/) | `Services.Folder` | A folder is a container used to organize multiple Service Types or other Folders. |
| [FolderPath](/reference/services/folder-path/) | `Services.FolderPath` | The Folder path of a Folder |
| [Item](/reference/services/item/) | `Services.Item` | An item in a plan. |
| [ItemAssignment](/reference/services/item-assignment/) | `Services.ItemAssignment` | An assignment of a person or position to a plan item. |
| [ItemNote](/reference/services/item-note/) | `Services.ItemNote` | A plan item note that belongs to a category. |
| [ItemNoteCategory](/reference/services/item-note-category/) | `Services.ItemNoteCategory` | A category of plan item notes for an entire Service Type. |
| [ItemTime](/reference/services/item-time/) | `Services.ItemTime` |  |
| [Key](/reference/services/key/) | `Services.Key` | Each song arrangement can have multiple keys. |
| [Live](/reference/services/live/) | `Services.Live` |  |
| [LiveController](/reference/services/live-controller/) | `Services.LiveController` | A person who can control Services LIVE without the required permissions |
| [Media](/reference/services/media/) | `Services.Media` | A piece of media |
| [MediaSchedule](/reference/services/media-schedule/) | `Services.MediaSchedule` |  |
| [NeededPosition](/reference/services/needed-position/) | `Services.NeededPosition` | An amount of unfilled positions needed within a team in a plan. |
| [Organization](/reference/services/organization/) | `Services.Organization` | The root level of an organization where account-level settings are applied. |
| [Person](/reference/services/person/) | `Services.Person` | A person added to Planning Center Services. |
| [PersonTeamPositionAssignment](/reference/services/person-team-position-assignment/) | `Services.PersonTeamPositionAssignment` | A person's assignment to a position within a team. |
| [Plan](/reference/services/plan/) | `Services.Plan` | A single plan within a Service Type. |
| [PlanImportMetadata](/reference/services/plan-import-metadata/) | `Services.PlanImportMetadata` | Metadata about a Plan or Template import |
| [PlanNote](/reference/services/plan-note/) | `Services.PlanNote` | A specific plan note within a single plan. |
| [PlanNoteCategory](/reference/services/plan-note-category/) | `Services.PlanNoteCategory` | A category of plan notes for an entire Service Type. |
| [PlanPerson](/reference/services/plan-person/) | `Services.PlanPerson` | A person scheduled within a specific plan. |
| [PlanPersonTime](/reference/services/plan-person-time/) | `Services.PlanPersonTime` |  |
| [PlanTemplate](/reference/services/plan-template/) | `Services.PlanTemplate` | A PlanTemplate Resource |
| [PlanTime](/reference/services/plan-time/) | `Services.PlanTime` | A time in a plan. |
| [PublicView](/reference/services/public-view/) | `Services.PublicView` | Manage options for a public plan |
| [ReportTemplate](/reference/services/report-template/) | `Services.ReportTemplate` | A template for generating reports |
| [Schedule](/reference/services/schedule/) | `Services.Schedule` | An instance of a PlanPerson with included data for displaying in a user's schedule |
| [ScheduledPerson](/reference/services/scheduled-person/) | `Services.ScheduledPerson` | A person already scheduled to a SignupSheet |
| [SchedulingPreference](/reference/services/scheduling-preference/) | `Services.SchedulingPreference` | Household member scheduling preference |
| [Series](/reference/services/series/) | `Services.Series` | A Series can be specified for each plan to tie plans with similar messages together, even across Service Types. |
| [ServiceType](/reference/services/service-type/) | `Services.ServiceType` | A Service Type is a container for plans. |
| [ServiceTypePath](/reference/services/service-type-path/) | `Services.ServiceTypePath` | The Folder path of a Service Type |
| [SignupSheet](/reference/services/signup-sheet/) | `Services.SignupSheet` | Available positions to sign up for |
| [SignupSheetMetadata](/reference/services/signup-sheet-metadata/) | `Services.SignupSheetMetadata` | A SignupSheetMetadata Resource |
| [SkippedAttachment](/reference/services/skipped-attachment/) | `Services.SkippedAttachment` | a skipped attachment |
| [Song](/reference/services/song/) | `Services.Song` | A song |
| [SongSchedule](/reference/services/song-schedule/) | `Services.SongSchedule` | A upcoming schedule for a song |
| [SongbookStatus](/reference/services/songbook-status/) | `Services.SongbookStatus` | Used to get the status of an in progress songbook action. |
| [SplitTeamRehearsalAssignment](/reference/services/split-team-rehearsal-assignment/) | `Services.SplitTeamRehearsalAssignment` | For Rehearsal/Other Times, maps a Split Team to selected Time Preference Options. |
| [Tag](/reference/services/tag/) | `Services.Tag` | A tag belonging to a tag group. |
| [TagGroup](/reference/services/tag-group/) | `Services.TagGroup` | A tag group contains tags |
| [Team](/reference/services/team/) | `Services.Team` | A Team within a Service Type. |
| [TeamLeader](/reference/services/team-leader/) | `Services.TeamLeader` | A leader of a specific Team in a Service Type. |
| [TeamPosition](/reference/services/team-position/) | `Services.TeamPosition` | A position within a team. |
| [TextSetting](/reference/services/text-setting/) | `Services.TextSetting` |  |
| [TimePreferenceOption](/reference/services/time-preference-option/) | `Services.TimePreferenceOption` | A Service Time a person prefers to be scheduled to. |
| [Zoom](/reference/services/zoom/) | `Services.Zoom` | Describes a zoom level for an attachment |

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