Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.outpost.pub/llms.txt

Use this file to discover all available pages before exploring further.

Outpost’s Dovetail integration connects to your PRX podcast hosting account and automatically creates a page on your site for each podcast episode. When new episodes are published in Dovetail, Outpost creates corresponding pages in Ghost with embedded audio, show notes, and metadata.

What syncs

Dovetail DataGhost Page
Episode titlePage title and meta title
Episode descriptionPage body content
Episode audio fileEmbedded audio player
Episode image (or podcast artwork)Featured image
Published datePage published date
Season and episode numbersPage metadata
Episode durationPage metadata
Sync direction is one-way: Dovetail to your Ghost site. Outpost also updates the episode URL in Dovetail to point back to the newly created page on your site.

Setup

1

Get your PRX API credentials

You will need your Client ID, Client Secret, API URL, and Podcasts API URL from your PRX/Dovetail account.
2

Connect in Outpost

Go to Settings → Integrations → Dovetail and enter your credentials. Click Connect to authenticate with the Dovetail API.
3

Select podcasts to sync

After connecting, Outpost retrieves a list of podcasts from your Dovetail account. Select which podcasts you want to sync to your site.
4

Configure per-podcast settings

For each selected podcast, configure how episodes should appear on your site (see Configuration options below).
5

Initial sync

Outpost runs an initial sync to import episodes. Depending on your import mode, this may pull in existing episodes or only start tracking new ones going forward.

Configuration options

Each podcast you sync has its own settings:
SettingDescription
Import modeChoose New episodes only to sync only episodes published after you connect, or All episodes to import your full back catalog.
Publish modeSet whether new episode pages are created as Draft or Published automatically.
AuthorsAssign one or more Ghost authors to episode pages.
TagsApply Ghost tags to all episode pages from this podcast.
DescriptionChoose to include the full description, first paragraph only, or no description in the page body.
Embed modeSelect Embed to include an inline audio player, or Theme to let your Ghost theme handle audio rendering.
Custom templateOptionally assign a Ghost custom template to episode pages.
Hide featured imageToggle whether the featured image is visible on the page.
Add metadataInclude the episode title as meta description (and optionally as custom excerpt).
Add summaryUse the first paragraph of the episode description as the custom excerpt.

Ongoing sync

After the initial setup, Outpost periodically checks Dovetail for new and updated episodes. New episodes are created as pages automatically, and updated episodes can be re-synced to reflect changes in title, description, or audio. When a new episode page is created, site administrators receive a notification with the episode title and a link to the new page.

FAQ

Yes. After connecting, you can select any number of podcasts from your account, each with its own configuration for tags, authors, publish mode, and more.
That depends on your Import mode setting. If set to New episodes only, older episodes are ignored. If set to All episodes, Outpost imports your existing catalog (up to 500 episodes per podcast).
Yes. Outpost periodically checks for updated episodes and can re-sync changes to titles, descriptions, images, and audio files.
Yes. When Outpost creates a page for an episode, it updates the episode’s URL in Dovetail to point to the new page on your site, so listeners can find the full page from podcast apps.
If an episode has a future release date in Dovetail, Outpost creates the page as a scheduled post in Ghost, timed to publish shortly after the episode goes live.