Docs

Add Spotify as a social connection

You will learn the following:

  • Use Spotify to authenticate users with OAuth

Enabling OAuth with Spotify allows your users to sign up and sign in to your Clerk application with their Spotify account.

Caution

For development instances, Spotify requires users to be added to the app's allowlist in order to use Spotify as a social provider in your Clerk app. If they are not allowlisted, any API requests made with an access token associated with that user and the Spotify app will receive a 403 status code.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Spotify Developer Dashboard.

Enable Spotify as a social connection in Clerk

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. In the Choose provider dropdown, select Spotify.
  4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
  5. Save the Redirect URI somewhere secure. Keep the modal and page open.

Create your app in Spotify

  1. On a separate page, go to the Spotify Developer Dashboard and sign in.
  2. In the top-right, select your profile button and select Dashboard.
  3. Select Create app.
  4. Complete the required fields. For Redirect URIs, add the Redirect URI that you saved from Clerk Dashboard.
  5. Select Save.
  6. On your app page, select Settings. Keep this page open.

Set the Client ID and Client Secret in the Clerk Dashboard

  1. In the Spotify app's settings page, save the Client ID and Client secret somewhere secure. To reveal the Client secret, you must select View client secret.
  2. Navigate back to the Clerk Dashboard where the modal should still be open and paste these values into the respective fields.
  3. Select Add connection.

Note

If the modal or page is not still open, navigate to the SSO connections page in the Clerk Dashboard. Select the Spotify connection. Under Use custom credentials, you can paste the Client ID and Client Secret into their respective fields.

Test your OAuth

The simplest way to test your OAuth is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to the Sign-in URL, select Visit. The URL should resemble:
  • For developmenthttps://your-domain.accounts.dev/sign-in
  • For productionhttps://accounts.your-domain.com/sign-in
  1. Sign in with your Spotify account.

Feedback

What did you think of this content?

Last updated on