← Back

Connect your own Spotify app

Hosting runs through a free Spotify developer app that you own — that way you control your own access and don't depend on anyone's user limits. Setting it up takes about 3 minutes and you only do it once.

1Create a Spotify app

  1. Open developer.spotify.com/dashboard/create (log in with the Spotify account you'll host parties with).
  2. App name and description: anything you like, e.g. "My Party DJ" — just don't use the word "Spotify" in the name.
  3. Redirect URI — this must match exactly, so copy it from here:

    Redirect URI

    https://controlfy.tcgdeck.net/api/auth/callback

  4. Under Which API/SDKs are you planning to use? tick Web API, accept the terms, and hit Save.

2Paste your app's credentials

In your new app's Settings, copy the Client ID, then click View client secret and copy that too.

Step 3 happens automatically: we verify the credentials with Spotify, then send you through Spotify's login to create your host account under your own app.

Your Client Secret is stored encrypted and only ever used server-side to talk to Spotify on your behalf. You need a Spotify Premium account to control playback.