Skip to content

Spotify Bulk API Onboarding

Overview

To gain access to the Bulk API, several steps need to be completed first. This is a necessary part of the onboarding process and allows us to set up your access quickly. Here are the high-level steps:

  1. Find your unique Spotify Licensor ID so we can configure your data access correctly.

  2. Find your Label Team's URI to ensure we add your account to the correct group.

  3. Set up a team email and use it to create a new Spotify account.

  4. Log in with your new Spotify account and agree to the Spotify For Developers terms of service.

  5. Review and agree to the terms of service for using the Bulk API.

  6. Send us an email that includes all of the information we've listed in these steps.

After you've completed these steps, we can then move forward with configuring our backend systems. Following this, we will provide you with the necessary access credentials. Additionally, you will receive private documentation related to the Bulk API. This will ensure you have the necessary resources to use the Bulk API effectively.

Step 1 - Locate your Spotify Licensor ID

You should already have a unique Spotify Licensor ID that has been shared with you. This ID is used to identify your organization, enabling us to properly configure your Bulk API data connection. The required ID follows this format:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

If you're having trouble finding this ID, your commercial partnership manager should be able to help you locate it.

Step 2 - Locate your Spotify Label Team ID

Your Spotify Label Team, which was established to give you access to Spotify's other products, has a unique ID. This ID, similar to the licensor ID, helps us identify your organization and correctly set up your user accounts. This ID follows a specific format: 

spotify:label:xxxxxxxxxxxxxxxxxxxxxx

If you can't locate this ID, your commercial partnership manager can assist you.

Please Note: During the content ingestion process, a team was created for your organization with the name '[Content Provider] Your Organization Name.' We cannot use this team to provide Bulk API access, so a new team may need to be created.

If you're certain your organization doesn't have a Spotify Label Team, please follow the instructions in the 'Labels and Distributors' section to create one.

A separate team will guide you through the setup process and inform you once it's finished. Once you receive their confirmation, you can consider this step completed.

Step 3 - Setting Up a New Spotify Account

It's recommended that you create a new email account on behalf of your organization. This should be a team email that's associated with your organizational domain. A suggested format could be "spotify-provider-api@<your_domain>.com".

Please Note: While personal accounts from your organization's domain are permitted, we've found it's generally more practical to establish a team account. This is because a team account allows for the sharing of API credentials and private documentation among several team members. So, if a team member leaves or changes their role, access won't be disrupted and there won't be a need to add new people. This method ensures a seamless and uninterrupted operation.

To set up a new Spotify account using this new email, please follow the steps provided here.

Step 4 - Enabling Your Developer Account

  1. First, visit the Spotify for Developers website and sign into your account.

  2. After you've logged in, look for your username displayed in the top-right corner of the screen and click on it.

  3. A dropdown menu will appear. Select the option that says "Dashboard".

  4. On this page, you'll be presented with the "Spotify Developer Terms".

  5. You'll find a checkbox labeled "I accept...". After carefully reading and understanding these terms, please click on this checkbox to confirm your agreement.

  6. To finalize the process, click on the button that says "Accept the terms".

Please Note: Any application you create in the dashboard won't work with the Bulk API. Instead, we will set up a dedicated application for you. This custom application will have the necessary permissions for accessing the Bulk API.

Step 5 - Accepting the Bulk API Terms of Service

To review the terms and conditions for using the API, please follow this link. 

After reviewing the terms, fill out the form with your organization's details and submit it.

Please Note: While one agreement is enough for your organization, it's essential to remember that these terms and conditions will also apply to any third parties to whom you provide your credentials for API access on your organization's behalf.

After submitting the form, a copy of the contract will be sent to the email address you used during the signing process.

Step 6 - Submit all required information

After completing all the previous steps, please submit all the required information using this form.

If you're having trouble accessing the form or encounter any errors, your commercial partnership manager can assist with the submission.

Next Steps

Once your information is submitted, we'll start processing your information and setting up our system with the appropriate user permissions. If everything goes smoothly, expect a welcome email from us within 3-5 business days. This email will contain further instructions on how to access the API. Should we need more information, we'll get in touch.