Skip to content
Documentation
Documentation
Products
Web API
Web Playback SDK
Ads API
iOS
Android
Embeds
Commercial Hardware
Open Access
Guidelines
Design
Accessibility
Legal
Community
0
Documentation
Documentation
Products
Web API
Web Playback SDK
Ads API
iOS
Android
Embeds
Commercial Hardware
Open Access
Guidelines
Design
Accessibility
Legal
Community
Ads API
Introduction
Introduction
Introduction
About
Next Steps
Support
Subscribe to Newsletter
API Design
Rate Limiting
Breaking v. Non-Breaking Changes Policy
Versioning
Time format
Pagination
Release Notes
Quickstart
Quickstart
Quickstart
Account Prerequisites
Initialize your new Ads API application
Authenticate your Ad Studio account
Using the refresh token
Guides
Guides
Guides
Object hierarchy
Ad Accounts
Campaigns
Ad Sets
Ads
Assets
Campaign Management
Overview
Differences from the UI
Build a Campaign
Reserved Buying
Reporting
Overview
Differences from the UI (Reporting)
Metrics Glossary
Conversions API
CAPI Setup Guide
CAPI Best Practices
Additional CAPI Resources
Custom Audiences
Overview
Creating a custom audience
Building with AI
Building with AI
Building with AI
Getting Started
Claude Code
OpenAI Codex
Antigravity CLI
Sample Prompts
Release Notes
Reference
General info
ad-accounts
ad-accounts
ad-accounts
Get Ad Account by ID
Update Ad Account
Get all members in an ad account.
Add a member to an ad account that belongs to a business.
Remove a member from an ad account.
Update an ad account member's role
Get Ad Accounts for a Business Member
Get Ad Accounts for Current User by Business ID
Create Ad Account
ad-categories
ad-categories
ad-categories
Get Ad Categories
ad-sets
ad-sets
ad-sets
Get Ad Set by ID
Update Ad Set
Create a Draft Ad Set from a Published Ad Set
Get Ad Sets by Ad Account ID
Create an Ad Set
Get Ad Set Drafts
Create a Draft Ad Set
Get Draft Ad Set by ID
Delete a Draft Ad Set
Update a Draft Ad Set
ads
ads
ads
Get Ads by Ad Account ID
Create an Ad
Get Ad by ID
Update an Ad
Create a Draft Ad from a Published Ad
Get Ad Drafts
Create a Draft Ad
Get Draft Ad by ID
Delete a Draft Ad
Update a Draft Ad
assets
assets
assets
Get Assets by Ad Account
Create Asset
Get Asset by ID
Update Asset
Upload Asset
Start Upload Chunked Asset
Transfer Chunked Asset
Complete Upload Chunked Asset
audiences
audiences
audiences
List Audiences accessible to an Ad Account
Create an Audience
Get an Audience
Delete an Audience
Edit an Audience
Get Signed GCS upload URL to upload a user list file
Get Signed GCS upload URL to upload a user list file for an existing audience
List Datasets eligible for creating Custom Audiences
businesses
businesses
businesses
Get Businesses for Current User
Create Business
Get Business by ID
Update Business
Get business members by business id based on the requesting user's permission
Accept a user invitation to join a business.
Get a member of a business
Remove a member from a business
Update a member's business user profile
Update a business member's role
Get pending business invitations
Invite a user to a business.
Cancel a user's invitation to a business.
campaigns
campaigns
campaigns
Get Campaigns by Ad Account ID
Create a Campaign
Get Campaign by ID
Update a Campaign
Create a Draft Campaign from a Published Campaign
Get Draft Campaigns
Create a Draft Campaign
Get Draft Campaign by ID
Publish or validate a draft campaign
Delete a Draft Campaign
Update a Draft Campaign
capi-measurement
capi-measurement
capi-measurement
Create CAPI Integration
Get CAPI Integration
Update CAPI Integration
Get CAPI Auth Token(s)
Create CAPI Auth Token
Delete CAPI Auth Token
change-history
change-history
change-history
Get Change History
estimates
estimates
estimates
Estimate audience
Estimate bid
experiments
experiments
experiments
Get Experiment Creation Availability for Ad Account
measurement-datasets
measurement-datasets
measurement-datasets
Get Datasets for Business
Create Dataset
Get Dataset
Update Dataset
Remove Integration From Dataset
Get Datasets for Ad Account
Get diagnostics for a dataset.
Share A Dataset With An Ad Account
Unshare A Dataset With An Ad Account
mobile-measurement
mobile-measurement
mobile-measurement
Get all mobile apps for a business
Create mobile app
Get the mobile app by its id.
Update the specified mobile app.
Get all mobile apps for an ad account
Share A Mobile App With An Ad Account
Unshare A Mobile App With An Ad Account
pixel-measurement
pixel-measurement
pixel-measurement
Get all pixels for a business account
Create pixel
Get pixel by id for a given business.
Update pixel
podcast-shows
podcast-shows
podcast-shows
Get Podcast Shows
pricing
pricing
pricing
Get pricing for a reserved ad product.
reports
reports
reports
Get Aggregated Totals by Ad Account ID
Get Aggregate Report by Ad Account ID
Get Insight Report by Ad Account ID
Create a CSV Report Asynchronously
Get CSV Report Status by ID
targets
targets
targets
Get Artist Targets
Get Genre Targets
Get Geo Targets
Get Interest Targets
Get Language Targets
Get Playlist Targets
Get Podcast Episode Topic Targets
Get Sensitive Topic Targets
Ads API
Introduction
Introduction
Introduction
About
Next Steps
Support
Subscribe to Newsletter
API Design
Rate Limiting
Breaking v. Non-Breaking Changes Policy
Versioning
Time format
Pagination
Release Notes
Quickstart
Quickstart
Quickstart
Account Prerequisites
Initialize your new Ads API application
Authenticate your Ad Studio account
Using the refresh token
Guides
Guides
Guides
Object hierarchy
Ad Accounts
Campaigns
Ad Sets
Ads
Assets
Campaign Management
Overview
Differences from the UI
Build a Campaign
Reserved Buying
Reporting
Overview
Differences from the UI (Reporting)
Metrics Glossary
Conversions API
CAPI Setup Guide
CAPI Best Practices
Additional CAPI Resources
Custom Audiences
Overview
Creating a custom audience
Building with AI
Building with AI
Building with AI
Getting Started
Claude Code
OpenAI Codex
Antigravity CLI
Sample Prompts
Release Notes
Reference
General info
ad-accounts
ad-accounts
ad-accounts
Get Ad Account by ID
Update Ad Account
Get all members in an ad account.
Add a member to an ad account that belongs to a business.
Remove a member from an ad account.
Update an ad account member's role
Get Ad Accounts for a Business Member
Get Ad Accounts for Current User by Business ID
Create Ad Account
ad-categories
ad-categories
ad-categories
Get Ad Categories
ad-sets
ad-sets
ad-sets
Get Ad Set by ID
Update Ad Set
Create a Draft Ad Set from a Published Ad Set
Get Ad Sets by Ad Account ID
Create an Ad Set
Get Ad Set Drafts
Create a Draft Ad Set
Get Draft Ad Set by ID
Delete a Draft Ad Set
Update a Draft Ad Set
ads
ads
ads
Get Ads by Ad Account ID
Create an Ad
Get Ad by ID
Update an Ad
Create a Draft Ad from a Published Ad
Get Ad Drafts
Create a Draft Ad
Get Draft Ad by ID
Delete a Draft Ad
Update a Draft Ad
assets
assets
assets
Get Assets by Ad Account
Create Asset
Get Asset by ID
Update Asset
Upload Asset
Start Upload Chunked Asset
Transfer Chunked Asset
Complete Upload Chunked Asset
audiences
audiences
audiences
List Audiences accessible to an Ad Account
Create an Audience
Get an Audience
Delete an Audience
Edit an Audience
Get Signed GCS upload URL to upload a user list file
Get Signed GCS upload URL to upload a user list file for an existing audience
List Datasets eligible for creating Custom Audiences
businesses
businesses
businesses
Get Businesses for Current User
Create Business
Get Business by ID
Update Business
Get business members by business id based on the requesting user's permission
Accept a user invitation to join a business.
Get a member of a business
Remove a member from a business
Update a member's business user profile
Update a business member's role
Get pending business invitations
Invite a user to a business.
Cancel a user's invitation to a business.
campaigns
campaigns
campaigns
Get Campaigns by Ad Account ID
Create a Campaign
Get Campaign by ID
Update a Campaign
Create a Draft Campaign from a Published Campaign
Get Draft Campaigns
Create a Draft Campaign
Get Draft Campaign by ID
Publish or validate a draft campaign
Delete a Draft Campaign
Update a Draft Campaign
capi-measurement
capi-measurement
capi-measurement
Create CAPI Integration
Get CAPI Integration
Update CAPI Integration
Get CAPI Auth Token(s)
Create CAPI Auth Token
Delete CAPI Auth Token
change-history
change-history
change-history
Get Change History
estimates
estimates
estimates
Estimate audience
Estimate bid
experiments
experiments
experiments
Get Experiment Creation Availability for Ad Account
measurement-datasets
measurement-datasets
measurement-datasets
Get Datasets for Business
Create Dataset
Get Dataset
Update Dataset
Remove Integration From Dataset
Get Datasets for Ad Account
Get diagnostics for a dataset.
Share A Dataset With An Ad Account
Unshare A Dataset With An Ad Account
mobile-measurement
mobile-measurement
mobile-measurement
Get all mobile apps for a business
Create mobile app
Get the mobile app by its id.
Update the specified mobile app.
Get all mobile apps for an ad account
Share A Mobile App With An Ad Account
Unshare A Mobile App With An Ad Account
pixel-measurement
pixel-measurement
pixel-measurement
Get all pixels for a business account
Create pixel
Get pixel by id for a given business.
Update pixel
podcast-shows
podcast-shows
podcast-shows
Get Podcast Shows
pricing
pricing
pricing
Get pricing for a reserved ad product.
reports
reports
reports
Get Aggregated Totals by Ad Account ID
Get Aggregate Report by Ad Account ID
Get Insight Report by Ad Account ID
Create a CSV Report Asynchronously
Get CSV Report Status by ID
targets
targets
targets
Get Artist Targets
Get Genre Targets
Get Geo Targets
Get Interest Targets
Get Language Targets
Get Playlist Targets
Get Podcast Episode Topic Targets
Get Sensitive Topic Targets
Ads API •
References / info
Ads API v3.0
Servers
Production server.
https://api-partner.spotify.com/ads/v3
Sandbox server for user testing.
https://api-partner.spotify.com/ads-sandbox/v3