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.

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 Mobile 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 Mobile

Section titled “Works on Lyricify Mobile”
  1. If you have already logged Spotify in Lyricify Mobile, then you will need to click Cancel button at open.
  2. Enter Client ID and Client Secret you previously obtained in welcome page’s Custom API Client part.
  3. Click Login (Get Token), finish the login and authorization, and you are good to go.

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 both lyricify://callback and http://127.0.0.1:766/callback, and not https://127.0.0.1:766/callback.
If you’re using an Android or iOS device, be sure to include lyricify://callback in the Redirect URI.
Please ensure you are using Lyricify Mobile version 1.5.0 or later and are using redirect to browser login. Due to Spotify’s adjustments, embedded web login is temporarily unavailable and will be restored in the next update.

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.