---
title: "Publishing reference"
description: "Planning Center Publishing in Planning Center Kit: Channels, episodes, series, speakers, and announcements."
---

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

# Publishing reference

Channels, episodes, series, speakers, and announcements.

| Property | Value |
| --- | --- |
| Client property | `pco.publishing` |
| Subpath import | `import { createPublishingClient } from '@mackenly/planningcenterkit/publishing'` |
| Types namespace | `Publishing` |
| Base path | `/publishing/v2` |
| Pinned API version | `2024-03-25` |
| Resource types | 18 |
| Planning Center docs | [Planning Center Publishing API](https://api.planningcenteronline.com/docs/apps/publishing/versions/2024-03-25) |

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

```ts
import { createPublishingClient } from '@mackenly/planningcenterkit/publishing';

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

## Root collections

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

| Client path | Resource | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `pco.publishing.announcement_categories` | [AnnouncementCategory](/reference/publishing/announcement-category/) | Collection |  | No |
| `pco.publishing.announcement_settings` | [AnnouncementSettings](/reference/publishing/announcement-settings/) | Single resource |  | No |
| `pco.publishing.announcements` | [Announcement](/reference/publishing/announcement/) | Collection | `active`, `active_and_scheduled`, `archived`, `inactive` | No |
| `pco.publishing.channels` | [Channel](/reference/publishing/channel/) | Collection | `archived`, `not_archived`, `podcast_enabled`, `published` | Yes |
| `pco.publishing.episodes` | [Episode](/reference/publishing/episode/) | Collection | `connected_to_services`, `not_connected_to_services`, `not_published_live`, `published_live`, `published_on_church_center` | Yes |
| `pco.publishing.series` | [Series](/reference/publishing/series/) | Collection | `not_published`, `published`, `published_on_church_center` | Yes |
| `pco.publishing.speakers` | [Speaker](/reference/publishing/speaker/) | Collection |  | No |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [Announcement](/reference/publishing/announcement/) | `Publishing.Announcement` |  |
| [AnnouncementCategory](/reference/publishing/announcement-category/) | `Publishing.AnnouncementCategory` |  |
| [AnnouncementSettings](/reference/publishing/announcement-settings/) | `Publishing.AnnouncementSettings` | Settings for how an Organization's Announcements are displayed |
| [AnnouncementsAnnouncementCategory](/reference/publishing/announcements-announcement-category/) | `Publishing.AnnouncementsAnnouncementCategory` |  |
| [AnnouncementsCampus](/reference/publishing/announcements-campus/) | `Publishing.AnnouncementsCampus` |  |
| [Channel](/reference/publishing/channel/) | `Publishing.Channel` | A collection of sermons |
| [ChannelDefaultEpisodeResource](/reference/publishing/channel-default-episode-resource/) | `Publishing.ChannelDefaultEpisodeResource` | The default EpisodeResources for a Channel |
| [ChannelDefaultTime](/reference/publishing/channel-default-time/) | `Publishing.ChannelDefaultTime` | The default times for a channel |
| [ChannelNextTime](/reference/publishing/channel-next-time/) | `Publishing.ChannelNextTime` | The next default time for a channel |
| [Episode](/reference/publishing/episode/) | `Publishing.Episode` |  |
| [EpisodeResource](/reference/publishing/episode-resource/) | `Publishing.EpisodeResource` |  |
| [EpisodeStatistics](/reference/publishing/episode-statistics/) | `Publishing.EpisodeStatistics` | Viewership statistics for an episode |
| [EpisodeTime](/reference/publishing/episode-time/) | `Publishing.EpisodeTime` | Live schedule times for an Episode |
| [NoteTemplate](/reference/publishing/note-template/) | `Publishing.NoteTemplate` |  |
| [Organization](/reference/publishing/organization/) | `Publishing.Organization` |  |
| [Series](/reference/publishing/series/) | `Publishing.Series` |  |
| [Speaker](/reference/publishing/speaker/) | `Publishing.Speaker` |  |
| [Speakership](/reference/publishing/speakership/) | `Publishing.Speakership` |  |

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