This guide shows how to create, update and delete a new app. The app provides, among others, the Client ID and Client Secret needed to implement any of the authorization flows.

To do so, go to your Dashboard and click on the Create an App button to open the following dialog box:

Create App Dialog

Enter an App Name and App Description of your choice (they will be displayed to the user on the grant screen), put a tick in the Developer Terms of Service checkbox and finally click on CREATE. Your application is now registered, and you’ll be redirected to the app overview page.

App Overview

The app overview page provides access to different elements:

  • App metrics, such as daily and monthly active users or number of users per country. Note that the metrics are initially empty.
  • App Status. By default, your app will be in Development Mode with limits on the number of users who can install it, and the number of API requests it can make. Note that you can request an extension of this quota if needed by clicking on the Request Extension link.
  • App settings.
  • Client ID, the unique identifier of your app.
  • Client Secret, the key you will use to authorize your Web API or SDK calls.

It is time to configure our app. Click on Edit Settings to view and update your app settings. The following dialog will show up:

Edit Settings View

  • Add a web domain or URL to the Website field. This will help users to obtain more information about your application.

  • In Redirect URIs enter one or more addresses that you want to allowlist with Spotify. This URI enables the Spotify authentication service to automatically invoke your app every time the user logs in (e.g. http://localhost:8080)

    Note that on iOS apps, the redirect URI must follow these rules:

    • All the characters are lowercase.
    • The prefix must be unique to your application (It cannot be a general prefix like http).
    • The prefix must only be used by your application for authenticating Spotify. If you already have a URL scheme handled by your application for other uses, do not reuse it.
    • Include a path after the first pair of forward slashes.

    For example: If your app name is My Awesome App, a good candidates for the redirect URI could be my-awesome-app-login://callback.

  • If you are developing an Android or iOS app, fill out the Android Package or Bundle IDs respectively.

Once you have finished updating the app settings, click on SAVE.

Finally, you can delete your app by clicking on the DELETE red button.