---
title: "Webhooks reference"
description: "Planning Center Webhooks in Planning Center Kit: Webhook subscriptions, available events, and deliveries."
---

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

# Webhooks reference

Webhook subscriptions, available events, and deliveries.

| Property | Value |
| --- | --- |
| Client property | `pco.webhooks` |
| Subpath import | `import { createWebhooksClient } from '@mackenly/planningcenterkit/webhooks-api'` |
| Types namespace | `Webhooks` |
| Base path | `/webhooks/v2` |
| Pinned API version | `2022-10-20` |
| Resource types | 5 |
| Planning Center docs | [Webhooks API](https://api.planningcenteronline.com/docs/apps/webhooks/versions/2022-10-20) |

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

```ts
import { createWebhooksClient } from '@mackenly/planningcenterkit/webhooks-api';

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

## Root collections

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

| Client path | Resource | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `pco.webhooks.available_events` | [AvailableEvent](/reference/webhooks/available-event/) | Collection |  | No |
| `pco.webhooks.webhook_subscriptions` | [WebhookSubscription](/reference/webhooks/webhook-subscription/) | Collection |  | Yes |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [AvailableEvent](/reference/webhooks/available-event/) | `Webhooks.AvailableEvent` | An event supported by webhooks |
| [Delivery](/reference/webhooks/delivery/) | `Webhooks.Delivery` |  |
| [Event](/reference/webhooks/event/) | `Webhooks.Event` |  |
| [Organization](/reference/webhooks/organization/) | `Webhooks.Organization` |  |
| [WebhookSubscription](/reference/webhooks/webhook-subscription/) | `Webhooks.WebhookSubscription` |  |

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