> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.beehiiv.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.beehiiv.com/_mcp/server.

# Podcast Episode Published

POST 

Reference: https://developers.beehiiv.com/webhooks/podcasts/episode-published

## Request

### Payload

- `data` (PodcastEpisodeData, optional)
- `event_timestamp` (integer, optional) — The date the event was created. Measured in seconds since the Unix epoch.
- `event_type` (string, optional) — The event type.
- `uid` (string, optional) — The prefixed event ID, unique to each webhook event.

## Types

### PodcastEpisodeData

- `id` (string, required) — The prefixed ID of the episode.
- `created` (integer, required) — The time the episode was created. Measured in seconds since the Unix epoch.
- `updated` (integer, required) — The time the episode was last updated. Measured in seconds since the Unix epoch.
- `title` (string, required) — The title of the episode.
- `slug` (string, required) — The web slug where this episode can be accessed.
- `displayed_date` (integer, required) — The time displayed in place of the `publish_date`. Measured in seconds since the Unix epoch.
- `description` (string, required) — A plain-text, truncated version of the episode show notes (max 255 characters).
- `show_notes` (string, required) — The full HTML show notes for the episode.
- `artwork_url` (string, required) — The URL of the episode artwork. Falls back to the podcast artwork when the episode has none. Empty string when no artwork is set.
- `status` (enum, required) — The status of the episode.
  - Allowed values: `draft`, `scheduled`, `published`, `archived`
- `show` (PodcastShowData, required) — The podcast this episode belongs to.
- `publish_date` (integer, optional) — The exact time the system published the episode (when it went live), not the scheduled time the user set for publication. Measured in seconds since the Unix epoch. Null when the episode has not been published.
- `duration` (integer, optional) — The duration of the episode audio in seconds. Null when no completed audio file is available.
- `season_number` (integer, optional) — The season number for the episode, if set.
- `episode_number` (integer, optional) — The episode number within the season, if set.
- `audio_url` (string, optional) — The public streaming URL for the episode audio. Null when no completed audio file is available.
- `transcript_url` (string, optional) — The WebVTT transcript URL for the episode. Null when transcripts are disabled or no completed transcript is available.

### PodcastShowData

- `id` (string, required) — The prefixed ID of the podcast.
- `created` (integer, required) — The time the podcast was created. Measured in seconds since the Unix epoch.
- `slug` (string, required) — The URL slug of the podcast.
- `description` (string, required) — The description of the podcast.
- `categories` (list of string, required) — Selected categories for the podcast, ordered by display position.
- `artwork_url` (string, required) — The URL of the podcast artwork. Empty string when no artwork is set.
- `status` (enum, required) — The status of the podcast.
  - Allowed values: `draft`, `live`, `archived`
- `language` (string, required) — The ISO 639-1 two-letter language code for the podcast.
- `title` (string, required) — The title of the podcast.
- `author` (string, required) — The author of the podcast.
- `type` (enum, required) — The type of the podcast.
  - Allowed values: `episodic`, `serial`
- `imported` (boolean, required) — Whether the podcast was created via an import.
- `copyright` (string, required) — The copyright text for the podcast.
- `explicit` (boolean, required) — Whether the podcast is marked as explicit.
- `publishing_frequency` (integer, optional) — The most common interval, in whole days, between consecutive published episodes.
- `website_url` (string, optional) — The website URL associated with the podcast.
- `platform_links` (map from string to string, optional) — Platform distribution URLs keyed by platform name. Present only for public podcasts.