Skip to main content
Outpost’s Megaphone integration auto-publishes new podcast episodes from your Megaphone shows as Ghost posts. You can also import your 200 most recent existing episodes, so podcast episodes show up alongside your written content.

​
What this integration does

  • Auto-publishes new episodes as Ghost posts as they go live on Megaphone
  • Imports your 200 most recent existing episodes as Ghost posts (one-time backfill)
  • Creates each post with the episode title, description, and audio player embed
  • Publishes according to your configured settings

​
Setup

  1. In Megaphone, get your API credentials from Settings → API Access.
  2. In Outpost, open the Megaphone integration and enter:
    • API Token: Your Megaphone API token.
    • Network API URL: Your Megaphone network API endpoint.
  3. Click Load Available Podcasts and choose the podcast to sync.
  4. Configure the podcast’s settings (see below).

​
Podcast settings

The integration connects one Megaphone podcast at a time, chosen from a dropdown. For the podcast you select:

​
Episode-to-post mapping

Outpost checks Megaphone for new episodes about every 15 minutes and publishes any it finds according to these settings.

​
Checking on the import

Below the podcast settings are three controls:
  • Check for New Episodes: click Check for New to run the regular check right away instead of waiting for the next one.
  • Full Refresh: click Full Refresh, then Refresh All Episodes to confirm. Outpost goes through the podcast’s 200 most recent episodes on Megaphone, imports any it hasn’t imported yet, recreates posts that were deleted, and rewrites the posts it already imported using your current settings (see the warning below). If a regular check finds an unusually large number of episodes to import at once, Outpost pauses the automatic checks and alerts the Outpost team to look into it. Full Refresh isn’t stopped by that limit, so use it when you mean to import a large batch.
  • Sync Status: Last checked shows how long ago Outpost last checked Megaphone, and Last successful how long ago a check last finished without an error. After three or more failed checks in a row, it also shows how many have failed. A check fails when Outpost can’t connect to Megaphone, for example when your API credentials stop working.
Saving the Megaphone settings, Check for New, and the automatic check only create posts for episodes that don’t have one yet. They never change a post Outpost has already imported, so edits you make in Ghost, such as tags, the excerpt, the feature image, a transcript you added, or the post’s status, are kept. They also don’t bring back a post you deleted in Ghost.
Full Refresh is the only action that changes posts Outpost has already imported. It rebuilds each post from Megaphone using your current settings and replaces:
  • The status. Each post is set to your Publish Mode, so a published episode goes back to draft when Publish Mode is Draft, and a post you moved back to draft is published again when it’s Published.
  • The tags. Tags you added by hand in Ghost are removed.
  • The post body, including a transcript or notes you added by hand.
  • The title, publish date, authors, feature image, and social sharing image.
  • The meta description, when Add Megaphone Description to the is set to Metadata field or Metadata and Excerpt fields, and the excerpt, when it’s set to Metadata and Excerpt fields.
  • The post’s code injection footer, and its template when Post Template is set.
Each post keeps its URL. A change you make to an episode on Megaphone after it’s imported only shows up on its post after a Full Refresh.

​
Re-importing episodes

To import episodes published before you connected, set Mode to Import Existing Episodes and save. Saving starts the import straight away and creates posts for the episodes that don’t have one yet, so set Publish Mode the way you want first. Disconnecting and reconnecting doesn’t import episodes again: episodes that already have a post are skipped. While Mode is Add Only New Episodes, older episodes are skipped, even by Full Refresh.