Enable Automatic Sermon Updates

A webhook is a secure notification sent when content changes. Kleis uses episode webhooks to queue a background refresh instead of requiring a manual full sync after every edit.

Prerequisites

Complete the first sync and make sure WordPress is publicly reachable over HTTPS. You need permission to manage Planning Center webhooks.

Copy the endpoint

1. Go to Settings > Kleis for Planning Center.
2. Find Webhook URL.
3. Click Click to reveal webhook URL.
4. Select the field to highlight the complete URL, then copy it.
5. Click Click to reveal webhook URL again to hide the field.

Keep this URL private. It includes a secret that authenticates incoming notifications.

Create the Planning Center webhook

1. Open the Planning Center Webhooks area linked from the Kleis settings page.
2. Create a webhook subscription for Planning Center Publishing episode changes.
3. Paste the complete Kleis Webhook URL as the destination.
4. Subscribe to episode create, update, and delete events available in the Publishing webhook interface.
5. Save and enable the webhook.
6. Use Planning Center’s test-delivery feature when available, or make a harmless change to a test episode.

Kleis validates the secret, queues the episode, and refetches the canonical episode data in the background. Delivery and WordPress processing may take a short time.

Do not shorten or edit the URL

The query value at the end is part of the authentication. A redacted URL is suitable for a screenshot but will not work as the webhook destination.

Verify an update

1. Change the title of a test episode in Planning Center Publishing.
2. Wait briefly, then refresh the corresponding Episode in WordPress.
3. Confirm the title changed.
4. Restore the original title and confirm that update arrives as well.

You should now see: Publishing episode changes reflected in WordPress without running another manual sync.

Recover failed updates

Kleis retries a failed episode update up to five times. If all attempts fail, an administrator notice shows the latest 100 unresolved failures. Expand View failed updates to see each episode ID, action, attempt count, and error code.

1. Resolve the connection or service error.
2. If requested, reconnect Planning Center in Kleis settings.
3. Select Retry failed updates in the notice.
4. Allow time for WordPress cron, then check the affected sermons.

Retrying moves failed updates back into the background queue. The notice returns if these updates fail again. A newer delivery for the same episode replaces its older failure. Interrupted processing resumes after a short recovery delay.

Next: Publish your first Kleis page.