Skip to content
Lyricify Icon Lyricify Docs

Custom Spotify API Client Configuration Tutorial

Benefits from customising Spotify API Client

Section titled “Benefits from customising Spotify API Client”

Spotify API won’t affect you by returning 429 Error anymore.

Requirements

Section titled “Requirements”

An active Spotify Premium subscription is required to use the Custom API Client.
Users who previously completed the configuration will also be required to have Spotify Premium starting March 9, 2026, otherwise the Custom API Client will no longer function.

Preparations

Section titled “Preparations”

If you have already completed the preparation steps, you can directly use the previously obtained Client ID and Client Secret in Works on Lyricify part.

  1. Login to Spotify (https://www.spotify.com) in your browser, if you have already logged in, go to step 2.
  2. Open https://developer.spotify.com/dashboard, if this is your first navigation to this website, you will need to agree with Spotify Developer Terms. Just check I accept the Spotify Developer Terms of Service and click Accept the terms.
  3. Click Create app in Dashboard’s right top corner.
    If you are prompted with You need to verify your email address before you can create an app., you need to verify your email address first.
  4. Fill Create app page with these:
    • App name: Lyricify
    • App description: Lyricify Custom API Client
    • Website: (Leave it empty)
    • Redirect URI:
  5. Check Web API in Which API/SDKs are you planning to use? section;
    Check I understand and agree with Spotify's Developer Terms of Service and Design Guidelines;
    Click Save.
  6. Now you can see your Client ID，Click View client secret to show the Client secret. Client ID and Client Secret are needed in future steps.

Works on Lyricify

Section titled “Works on Lyricify”
  1. If you have already logged Spotify in Lyricify, then you will need to log it out first.
  2. Click Configure Custom API Client in welcome page’s left bottom corner.
  3. Enter Client ID and Client Secret you previously obtained.
  4. Continue the login, and just enjoy Lyricify.

Common Issues

Section titled “Common Issues”

Error during authorization: INVALID_CLIENT: Invalid redirect URI

Section titled “Error during authorization: INVALID_CLIENT: Invalid redirect URI”

Please check if the Redirect URI is entered correctly. Make sure it includes http://127.0.0.1:766/callback and not https://127.0.0.1:766/callback.

Important Note

Section titled “Important Note”

If you created and configured your custom API Client before April 9, 2025, please make sure to update your app settings in the Spotify Developer Dashboard. Due to recent changes in Spotify’s redirect URI validation, URIs using localhost are no longer accepted. You need to replace the original:

http://localhost:766/callback

with:

http://127.0.0.1:766/callback

Go to your app’s settings page, and add http://127.0.0.1:766/callback under the Redirect URIs section. Once updated, your custom API Client should work properly during authorization.