# Megaphone Cuepoints API

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

Megaphone Cuepoints 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 Cuepoints. The published artifact set on APIs.io includes an OpenAPI specification.

**⚠️ IMPORTANT: Sponsorship Cuepoints ⚠️** These endpoints manage **all cuepoints** on an episode, including: - **Ad Cuepoints**: Standard ad break markers (preroll, midroll, postroll) - **Sponsorship Cuepoints**: Locations for sponsorship content (`cuepointType: "sponsorship"`) **⚠️ When using the PUT endpoint to replace cuepoints, ALL existing cuepoints are deleted and replaced with the provided array. This includes Sponsorship Cuepoints. If you do not include Sponsorship Cuepoints in your array, they will be permanently deleted.** Deleting a Sponsorship Cuepoint removes the target from any Sponsorship using it, potentially putting the Sponsorship in `inactive` status. For Embedded Sponsorships, if the cuepoint is removed, the original content will play, but analytics will not be tracked.

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/episodes/{episode_id}/cuepoints_batch` | Create a New Episode Cuepoint |
| PUT | `/api/episodes/{episode_id}/cuepoints_batch` | Replace all Episode Cuepoints |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/megaphone/openapi/megaphone-cuepoints-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

Cuepoints

---

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