Skip to main content

Spotify Ads

info

API Documentation: Spotify Ads API Documentation

High-Level Information: The Spotify Ads API enables access to advertising data and management on Spotify, including ad accounts, campaigns, ad sets, ads, assets and reporting (aggregate, insight, and asynchronous CSV reports).

Overview​

The spotify_ads connector lets you connect to Spotify Ads to work with your advertising data.

Use this source to authenticate with Spotify and select the Spotify Ad Account you want to sync from.

Authentication​

To authenticate with Spotify Ads, you’ll need OAuth credentials for the Spotify Ads Partner API.

Provide the following:

  • Client ID (client_id)
  • Client Secret (client_secret)
  • Refresh Token (token)

The connector uses your refresh token to request short-lived access tokens from:

  • https://accounts.spotify.com/api/token

Ensure the Spotify user/token has access to the Business and Ad Account you want to use. During setup, the connector will list available ad accounts so you can select the correct Ad Account ID.

Source Setup Guide​

Step 1​

banner in the Edit Source form to the left.

Step 2​

Follow the authentication flow (OAuth) in Spotify to grant Extract the required permissions.

Step 3​

Confirm you can see your email and profile picture, and that the source is Connected.

Connection Setup Guide​

Once you connected Spotify Ads to a destination, you will also need to configure:

  • Connection Pull Schedule: Determines how frequently data is extracted from the source.
  • Backfill (Days): Specifies the duration for which historical data will be retrieved during each connection run.
  • Destination specific settings: different settings such as "Dataset Name" or "Target Schema" (depending on your destination)
  • Schema Migration Policy: Controls how Extract will handle schema changes from the source.

If you are using the Spotify Audiences destination, you will also be prompted to select:

  • Ad Account: The Spotify Ads ad account to load the audience into.
  • Audience selection: Choose an existing audience or select Create new audience....
  • Seed audience (optional): Select an existing audience to use as a seed when creating a new audience.

Configuration​

Provide the following configuration values to connect to Spotify Ads.

This connector uses OAuth credentials.

  • Client ID (client_id): Your Spotify Ads API client ID.
  • Client secret (client_secret): Your Spotify Ads API client secret.
  • Token (token): OAuth token configuration used to obtain access tokens.

Destination settings (Audiences)​

  • Ad account (ad_account_id, required): The Spotify Ad Account to load audiences into. This list is populated dynamically after authentication.
  • Audience selection (audience_selection): Choose an existing audience to update, or select Create new audience....
  • Seed audience (seed_audience_id): Select an existing audience to use as the seed when creating a new audience (only applicable when creating a new audience).

Connector Information​

  • Authentication: OAuth 2.0 (Spotify Ad Studio account)

Schema ERD​

Explore the interactive entity relationship diagram for Spotify Ads.

Open page

Data Streams​

ad_accounts​

Loading ....

ads​

Loading ....

ads_third_party_tracking​

Loading ....

ad_sets​

Loading ....

ad_sets_frequency_caps​

Loading ....

ad_sets_promotion_conversion_events​

Loading ....

assets​

Loading ....

campaigns​

Loading ....

ad_account_level_aggregated_report​

Loading ....

ad_level_aggregated_report​

Loading ....

ad_set_level_aggregated_report​

Loading ....

campaign_level_aggregated_report​

Loading ....

ad_set_insights_by_age​

Loading ....

ad_set_insights_by_country​

Loading ....

ad_set_insights_by_gender​

Loading ....

ad_set_insights_by_genre​

Loading ....

ad_set_insights_by_platform​

Loading ....

Notes​

  • This connector supports Spotify Audiences as a destination. When loading customer lists, Spotify enforces minimum and maximum upload constraints:
    • Minimum rows: 1,000 identifiers per customer list upload.
    • Maximum file size: 1 GB per upload.
  • Uploads use a resumable upload flow and may take several minutes for large lists (the connector allows up to ~10 minutes per upload attempt).
  • Identifiers are SHA-256 hashed before upload. Ensure your source data is normalized consistently (for example, trimming whitespace and using a consistent casing strategy) to avoid mismatches.
  • Audience selection supports either creating a new audience or updating an existing audience (selected via the audience_selection parameter).