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

# Dovetail (PRX) Integration

> Automatically create podcast episode pages from your Dovetail podcasts hosted on PRX.

Outpost's Dovetail integration connects to your [PRX](https://www.prx.org/) 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 Data                      | Ghost Page                                                                   |
| ---------------------------------- | ---------------------------------------------------------------------------- |
| Episode title                      | Page title and meta title                                                    |
| Episode description                | Page body content                                                            |
| Episode audio file                 | Embedded audio player                                                        |
| Episode image (or podcast artwork) | Featured image, plus an auto-generated social sharing image for shared links |
| Published date                     | Page published date                                                          |
| Season and episode numbers         | Page metadata                                                                |
| Episode duration                   | Page 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

<Steps>
  <Step title="Get your PRX API credentials">
    You will need your **Client ID**, **Client Secret**, **API URL**, and **Podcasts API URL** from your PRX/Dovetail account.
  </Step>

  <Step title="Connect in Outpost">
    Go to **Settings → Integrations → Dovetail** and enter your credentials. Click **Connect** to authenticate with the Dovetail API.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Configure per-podcast settings">
    For each selected podcast, configure how episodes should appear on your site (see Configuration options below).
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Configuration options

Each podcast you sync has its own settings:

| Setting                 | Description                                                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Import mode**         | Choose **New episodes only** to sync only episodes published after you connect, or **All episodes** to import your full back catalog. |
| **Publish mode**        | Set whether new episode pages are created as **Draft** or **Published** automatically.                                                |
| **Authors**             | Assign one or more Ghost authors to episode pages.                                                                                    |
| **Tags**                | Apply Ghost tags to all episode pages from this podcast.                                                                              |
| **Description**         | Choose to include the **full description**, **first paragraph only**, or **no description** in the page body.                         |
| **Embed mode**          | Select **Embed** to include an inline audio player, or **Theme** to let your Ghost theme handle audio rendering.                      |
| **Custom template**     | Optionally assign a Ghost custom template to episode pages.                                                                           |
| **Hide featured image** | Toggle whether the featured image is visible on the page.                                                                             |
| **Add metadata**        | Include the episode title as meta description (and optionally as custom excerpt).                                                     |
| **Add summary**         | Use 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

<AccordionGroup>
  <Accordion title="Can I sync multiple podcasts from one Dovetail account?">
    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.
  </Accordion>

  <Accordion title="What happens to episodes published before I connected?">
    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).
  </Accordion>

  <Accordion title="Will Outpost update existing episode pages if I change something in Dovetail?">
    Yes. Outpost periodically checks for updated episodes and can re-sync changes to titles, descriptions, images, and audio files.
  </Accordion>

  <Accordion title="Does Outpost update the episode URL in Dovetail?">
    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.
  </Accordion>

  <Accordion title="Can I schedule episode pages for future publication?">
    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.
  </Accordion>
</AccordionGroup>