# Megaphone Promo API v2 API

**Canonical:** https://apis.io/apis/megaphone/megaphone-promo-api-v2-api/  
**Provider:** Megaphone — https://apis.io/providers/megaphone/  
**Base URL:** https://cms.megaphone.fm  
**Documentation:** https://developers.megaphone.fm/

Megaphone Promo API v2 API is one of 21 APIs that [Megaphone](https://apis.io/providers/megaphone/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Promo API v2. The published artifact set on APIs.io includes an OpenAPI specification.

**⚠️ AVAILABILITY ⚠️** The Promo API v2 provides endpoints for managing promos, promo advertisements, and promo assets. - **Base URL:**`https://cms.megaphone.fm/api/v2` - **Available From:** May 15, 2026 00:00:00 UTC #### Migration Timeline - **Before May 15, 2026:** v2 promo endpoints not yet available; use legacy endpoints. - **May 15 - July 14, 2026:** Legacy endpoints and v2 promo endpoints work during the migration period. - **After July 14, 2026 11:59:59 UTC:** Legacy promo endpoints are removed. #### Key Differences from Orders API v2 - `promotedPodcastId` is a promo-level field and must be a Megaphone podcast UUID from the requested organization when provided. - Promo content targeting accepts Megaphone UUIDs under `shows` and `episodes`. - `includeAudienceTargets` & `topics` are not supported for promos. - Order-specific fields such as `impressionsCap`, `pacingType`, `cpmRate`, `adHash`, `copy`, and `dcmLineItemId` do not exist on promos. - DELETE is not supported. Archive a Promo, Promo Advertisement, or Promo Asset with `PATCH` and `status: "archived"`.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/organizations/{organization_id}/promos` | List All Promos |
| POST | `/api/v2/organizations/{organization_id}/promos` | Create a Promo |
| GET | `/api/v2/organizations/{organization_id}/promos/{promo_id}` | Get a Promo |
| PATCH | `/api/v2/organizations/{organization_id}/promos/{promo_id}` | Update a Promo |
| GET | `/api/v2/organizations/{organization_id}/promos/assets` | List All Promo Assets |
| POST | `/api/v2/organizations/{organization_id}/promos/assets` | Create a Promo Asset |
| GET | `/api/v2/organizations/{organization_id}/promos/assets/{asset_id}` | Get a Promo Asset |
| PATCH | `/api/v2/organizations/{organization_id}/promos/assets/{asset_id}` | Update a Promo Asset |
| POST | `/api/v2/organizations/{organization_id}/promos/assets/{asset_id}/start-chunked-upload` | Start Chunked Upload |
| POST | `/api/v2/organizations/{organization_id}/promos/assets/{asset_id}/transfer-chunked-upload` | Transfer Chunked Upload |
| POST | `/api/v2/organizations/{organization_id}/promos/assets/{asset_id}/complete-chunked-upload` | Complete Chunked Upload |
| GET | `/api/v2/organizations/{organization_id}/promos/{promo_id}/advertisements` | List All Promo Advertisements |
| POST | `/api/v2/organizations/{organization_id}/promos/{promo_id}/advertisements` | Create a Promo Advertisement |
| GET | `/api/v2/organizations/{organization_id}/promos/{promo_id}/advertisements/{advertisement_id}` | Get a Promo Advertisement |
| PATCH | `/api/v2/organizations/{organization_id}/promos/{promo_id}/advertisements/{advertisement_id}` | Update a Promo Advertisement |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/megaphone/openapi/megaphone-promo-api-v2-api-openapi.yml

## Other Megaphone APIs (12)

- [Megaphone Campaigns API](https://apis.io/apis/megaphone/megaphone-campaigns-api/)
- [Megaphone Direct Sales v2 API](https://apis.io/apis/megaphone/megaphone-direct-sales-v2-api/)
- [Megaphone Episodes API](https://apis.io/apis/megaphone/megaphone-episodes-api/)
- [Megaphone Exports API](https://apis.io/apis/megaphone/megaphone-exports-api/)
- [Megaphone Networks API](https://apis.io/apis/megaphone/megaphone-networks-api/)
- [Megaphone Orders API](https://apis.io/apis/megaphone/megaphone-orders-api/)
- [Megaphone Podcasts API](https://apis.io/apis/megaphone/megaphone-podcasts-api/)
- [Megaphone Advertisements API](https://apis.io/apis/megaphone/megaphone-advertisements-api/)
- [Megaphone Advertiser Categories API](https://apis.io/apis/megaphone/megaphone-advertiser-categories-api/)
- [Megaphone Advertisers API](https://apis.io/apis/megaphone/megaphone-advertisers-api/)
- [Megaphone Agencies API](https://apis.io/apis/megaphone/megaphone-agencies-api/)
- [Megaphone Campaign Orders API](https://apis.io/apis/megaphone/megaphone-campaign-orders-api/)

## Tags

Promo API v2

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/megaphone/megaphone-promo-api-v2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/megaphone/.