# spotify-ads-api

A Claude plugin that runs Spotify ad campaigns from plain text: set up campaigns and ads, then pull performance reports.

- plugin · `type=plugin` · Claude Code · ★ 20
- Author: spotify
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/spotify/ads-agentic-tools
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/plugins/spotify-ads-api

## What it does

The plugin adds slash commands and skills to Claude for the Spotify Ads API. You describe a campaign, audience, ad or report in words, and the plugin turns that into API calls. Sign-in happens in the browser; tokens land on disk and refresh on their own before each request, so you do not repeat the OAuth dance.

Setup needs a Spotify Developer account whose app has Ads API enabled, plus your ad account ID. The team administrator hands out a client ID; the application secret is never requested. Run `/spotify-ads-api:configure` to start. PKCE authorization relies on Python 3.8+ or `uv`, and on Windows you also need Git Bash because the token refresh hook is a bash script.

After that, commands like `/spotify-ads-api:build-campaign` do the work. Access is bound to the ad account whose terms you accepted on the Ads API page, so the wrong account selection is enough to break the whole flow.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin install spotify-ads-api@claude-plugins-official
```
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-official
```

## When to use it
- launch a campaign from a one-line brief
- generate a spend and impressions report
- target listeners by age and country
- create an ad inside an existing campaign
- keep OAuth tokens fresh between sessions

## Example prompts
- /spotify-ads-api:configure
- Pull a report for the last campaign this week

## Similar
- [claude-seo](https://affpapa.org/en/nevibecode/plugins/claude-seo.md) — plugin · ★ 21467
- [search-console-mcp](https://affpapa.org/en/nevibecode/plugins/search-console-mcp.md) — plugin · ★ 2020
- [voltagent-research](https://affpapa.org/en/nevibecode/plugins/voltagent-research.md) — plugin · ★ 26065
- [hermes-tweet](https://affpapa.org/en/nevibecode/plugins/hermes-tweet.md) — plugin · ★ 41729
- [social-publishing](https://affpapa.org/en/nevibecode/plugins/social-publishing.md) — plugin · ★ 41729
- [content-marketing](https://affpapa.org/en/nevibecode/plugins/content-marketing.md) — plugin · ★ 41729

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md