# Spotify Ads tools in Cogny Cogny's Spotify Ads integration exposes 22 tools (13 read, 9 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. > New connections open once Spotify allowlists Cogny's app for the Ads API. - **Read** (13): only reads data. - **Write** (9): creates or changes something. - **Destructive** (0): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## Connecting and limits Connecting signs you in with Spotify. The Spotify Ads API has no permission scopes to pick from: Cogny can reach the ad accounts your Spotify login has a role on in Spotify Ads Manager. After connecting you pick which of them the workspace may use; the others are refused. Changes are made only after you confirm each one: pausing and resuming campaigns, ad sets and ads, changing an ad set's budget, uploading an audio file or an image, and creating a campaign, an audio ad set and an audio ad. A new ad set and a new ad are created with delivery off, so nothing is spent until you turn delivery on. Turning delivery on starts spending. An audio ad needs three files: the audio (MP3, WAV or OGG, at most 30 seconds), a companion image and a logo (each square, at least 600×600, JPEG or PNG, at most 200 KB). They are uploaded from a public https link, up to 20 MB each. Cogny's `create_audio_ad` makes all three. An ad set targets one country; for several countries, make one ad set each. Spotify reviews every new ad before it can play. Daily reports cover at most 90 days per request; hourly reports cover the last two weeks. Audience insight reports (age, gender, country, platform, genre and more) cover a campaign's or ad set's lifetime and only appear once it has delivered enough to pass Spotify's privacy threshold. ## Known gaps - Only audio ads can be built: no video, image or podcast-host-read ads, and no video uploads. - An ad set's targeting is country (with optional regions and cities), age, gender, device platform, listener language, and music or podcast placement. Genre, interest, playlist, artist-fan and custom-audience targeting can't be set from Cogny yet. - The upload, estimate and create tools are new (November 2026). If Spotify refuses a request, the tool answers with Spotify's own message. - No tools for drafts. If Spotify doesn't let your login edit a published ad set or ad directly, make the change as a draft in Spotify Ads Manager. - Campaigns can't be archived from Cogny, and an existing ad set's targeting, bid and schedule and an existing ad's text can't be edited yet. - No tools for audiences beyond listing them, for the Spotify Pixel or Conversions API setup, or for business and member administration. ## All tools | Tool | Kind | What it does | |---|---|---| | `tool_list_ad_accounts` | Read | List the Spotify ad accounts the connection can reach, with business, currency and role. | | `tool_get_ad_account` | Read | Get one Spotify ad account's details: name, status, currency, country and industry. | | `tool_get_campaigns` | Read | List the campaigns in a Spotify ad account with status and objective. | | `tool_get_ad_sets` | Read | List ad sets with budget, schedule, bidding, targeting and whether each is paused. | | `tool_get_ads` | Read | List ads with tagline, call to action, assets, delivery and review status. | | `tool_list_audiences` | Read | List the custom and lookalike audiences of a Spotify ad account with size and status. | | `tool_get_aggregate_report` | Read | Get Spotify ad performance (impressions, reach, spend, clicks, completes, streams…) per campaign, ad set or ad. | | `tool_get_insight_report` | Read | Break one Spotify campaign or ad set's results down by audience: age, gender, country, platform, genre and more. | | `tool_get_csv_report` | Read | Check a CSV report started with tool_create_csv_report and get its download link once ready. | | `tool_create_csv_report` | Write | Start a downloadable CSV performance report in Spotify Ads Manager. | | `tool_update_campaign_status` | Write | Pause or resume a Spotify campaign. | | `tool_update_ad_set_delivery` | Write | Pause (delivery OFF) or resume (delivery ON) a Spotify ad set. | | `tool_update_ad_set_budget` | Write | Change a Spotify ad set's budget. | | `tool_update_ad_delivery` | Write | Pause (delivery OFF) or resume (delivery ON) a single Spotify ad. | | `tool_search_geo_targets` | Read | Find the countries, regions and cities Spotify ads can target, with their ids. | | `tool_list_ad_categories` | Read | Find the Spotify ad category (industry) id an ad set should carry, e.g. | | `tool_estimate_audience` | Read | Forecast an audio ad set before creating it: reach and impressions, a bid range, and whether the budget is likely to be spent. | | `tool_list_assets` | Read | List the audio and image files uploaded to a Spotify ad account, with their ids and processing status. | | `tool_upload_asset` | Write | Upload an audio file or an image to a Spotify ad account from a URL, for use in an ad. | | `tool_create_campaign` | Write | Create a Spotify campaign: the empty container an ad set and its ads go into. | | `tool_create_ad_set` | Write | Create a Spotify audio ad set in a campaign: the budget, schedule, bid and audience its ads run with. | | `tool_create_ad` | Write | Create a Spotify audio ad in an ad set from uploaded assets, and send it to Spotify's review. | Exact input schemas come from `tools/list` once Spotify Ads is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt