{"slug":"spotify","name":"Spotify","domain":"spotify.com","category":"Music streaming","summary":"You can register an app and connect your own account in minutes. To go further you need a Premium subscription, and reaching the public requires extended quota, which Spotify grants only to registered businesses with at least 250k monthly active users after a review of up to six weeks.","tier":"gated","tierReason":"Development mode caps you at 5 allowlisted users, and since May 15, 2025 only registered organizations with at least 250k MAU and a launched service can apply for extended quota.","quality":"researched","updatedAt":"2026-10-27","composio":{"status":"byo","note":"Composio has no managed Spotify app, so you register your own Spotify app and enter its client ID and secret in Composio. Because the developer pays for it, your Spotify account needs Premium.","toolkit":"spotify"},"totals":{"effort":{"min":2,"max":8,"unit":"hours"},"wait":{"min":0,"max":6,"unit":"weeks"},"firstConnection":"Today, in about 15 minutes, if your Spotify account has Premium"},"stages":[{"id":"build","name":"Your account","whoCanConnect":"You, the app owner. Your account must have an active Premium subscription.","userSees":"Spotify's consent screen with your app name and description.","effort":{"min":10,"max":30,"unit":"minutes"},"wait":{"min":0,"max":0,"unit":"minutes"},"unlock":"Add up to 5 users to the app's allowlist under Users and Access.","evidence":{"kind":"docs","sources":["s1","s2","s3"],"confidence":"high"}},{"id":"beta","name":"Development mode","whoCanConnect":"Up to 5 Spotify users you add to the allowlist by name and email. Anyone else gets 403 errors.","userSees":"The normal consent screen. Some endpoints and response fields aren't available in development mode.","effort":{"min":5,"max":15,"unit":"minutes"},"wait":{"min":0,"max":0,"unit":"minutes"},"unlock":"Get approved through the Partner Application, then get your quota extension request approved. You must be a registered organization with at least 250k MAU.","evidence":{"kind":"docs","sources":["s1","s3"],"confidence":"high"}},{"id":"launch","name":"Extended quota","whoCanConnect":"Any Spotify user. The allowlist no longer applies.","userSees":"The normal consent screen.","effort":{"min":2,"max":8,"unit":"hours"},"wait":{"min":0,"max":6,"unit":"weeks"},"unlock":null,"evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}}],"requirements":[{"id":"spotify-premium","label":"Spotify Premium on the owner account","detail":"Development-mode apps stop working if the owner's Premium subscription lapses. They start working again when the owner resubscribes.","stage":"build","actor":"you","evidence":{"kind":"docs","sources":["s1","s3"],"confidence":"high"}},{"id":"https-redirect","label":"HTTPS redirect URI or loopback IP","detail":"Redirect URIs must use HTTPS. For local testing you can use http://127.0.0.1 or http://[::1]. The hostname 'localhost' is rejected.","stage":"build","actor":"agent","evidence":{"kind":"docs","sources":["s4"],"confidence":"high"}},{"id":"registered-business","label":"Legally registered business or organization","detail":"Spotify hasn't accepted extended quota requests from individuals since May 15, 2025.","stage":"launch","actor":"you","evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"id":"mau-250k","label":"Launched service with at least 250k MAU","detail":"You need an active, launched service with at least 250k monthly active users. It must be available in key Spotify markets, be commercially viable and comply with Spotify's terms.","stage":"launch","actor":"you","evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"id":"company-email","label":"Company email address","detail":"You must submit the Partner Application from a company email address.","stage":"launch","actor":"you","evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}}],"steps":[{"id":"sign-in-dashboard","title":"Sign in to the Spotify Developer Dashboard","actor":"you","stage":"build","time":{"min":2,"max":5,"unit":"minutes"},"detail":"Sign in with the Spotify account that will own the app. This account needs active Premium.","actions":["Open developer.spotify.com/dashboard","Sign in and accept the developer terms if prompted"],"gotcha":"If the owner account is on the free plan, development-mode apps don't work.","link":{"label":"Spotify Developer Dashboard","url":"https://developer.spotify.com/dashboard"},"evidence":{"kind":"docs","sources":["s2","s3"],"confidence":"high"}},{"id":"create-app","title":"Create the app","actor":"agent","stage":"build","time":{"min":3,"max":5,"unit":"minutes"},"detail":"Click Create app and fill in the name and description. Users see both on the consent screen. Add a website and your redirect URI, select Web API, and accept the Developer Terms. A person should confirm the terms checkbox.","actions":["App name and App description","Website (optional)","Redirect URIs: your OAuth client's callback URL, which must match exactly","Select the Web API","Check the Developer Terms of Service box and click Save"],"agentNote":"An agent can fill in the form. A person should accept the Developer Terms.","gotcha":"'localhost' redirect URIs are rejected. Use 127.0.0.1 or an HTTPS URL.","link":{"label":"Create app","url":"https://developer.spotify.com/dashboard/create"},"image":{"url":"https://developer-assets.spotifycdn.com/images/documentation/web-api/createappdialog.png","alt":"Create App dialog","source":"s2"},"evidence":{"kind":"docs","sources":["s2","s4"],"confidence":"high"}},{"id":"copy-credentials","title":"Copy the client ID and secret into your OAuth client","actor":"you","stage":"build","time":{"min":2,"max":5,"unit":"minutes"},"detail":"Under Settings, copy the client ID and reveal the client secret. Store both in your OAuth client. The authorize URL is https://accounts.spotify.com/authorize and the token URL is https://accounts.spotify.com/api/token.","actions":["Open the app, then Settings","Copy the Client ID","Click View client secret and store it securely"],"agentNote":"An agent can copy the client ID. A person handles the client secret.","gotcha":"If the secret leaks, rotate it. Rotating breaks existing configurations until you update them.","link":{"label":"Spotify Developer Dashboard","url":"https://developer.spotify.com/dashboard"},"image":{"url":"https://developer-assets.spotifycdn.com/images/documentation/web-api/app_overview.png","alt":"App overview page with credentials","source":"s2"},"evidence":{"kind":"docs","sources":["s2"],"confidence":"high"}},{"id":"test-own-connection","title":"Connect your own Spotify account","actor":"agent","stage":"build","time":{"min":5,"max":10,"unit":"minutes"},"detail":"Run the authorization flow with the scopes you need, for example user-read-email or playlist-read-private, and confirm API calls succeed.","actions":["Start the OAuth flow from your OAuth client","Approve the consent screen","Call /v1/me to verify the token"],"agentNote":"An agent can drive the test. A person may need to sign in to Spotify.","gotcha":"Development-mode apps have endpoints removed, such as batch fetches and other users' playlists. Search is capped at 10 results per page.","evidence":{"kind":"docs","sources":["s3"],"confidence":"high"}},{"id":"allowlist-users","title":"Add up to 5 users to the allowlist","actor":"agent","stage":"beta","time":{"min":2,"max":10,"unit":"minutes"},"detail":"In the app's Settings, open Users and Access and add each tester's name and the email address on their Spotify account.","actions":["Settings → User Management / Users and Access","Add the name and Spotify email for each tester"],"agentNote":"An agent can add users once you've collected their emails.","gotcha":"The email must match the tester's Spotify account. Users who aren't on the list get 403 errors.","link":{"label":"Spotify Developer Dashboard","url":"https://developer.spotify.com/dashboard"},"image":{"url":"https://developer-assets.spotifycdn.com/images/documentation/web-api/users-and-access.png","alt":"Users and Access settings","source":"s1"},"evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"id":"partner-application","title":"Submit the Spotify Partner Application","actor":"you","stage":"launch","time":{"min":1,"max":3,"unit":"hours"},"detail":"Submit the Partner Application form linked from the quota modes page, using a company email address. You must meet the organization and 250k MAU criteria.","actions":["Open the Partner Application link on the quota modes page","Submit company and product details from a company email address"],"agentNote":"An agent can draft answers. A person submits the form.","gotcha":"Spotify turns away individuals and pre-launch products.","link":{"label":"Quota modes","url":"https://developer.spotify.com/documentation/web-api/concepts/quota-modes"},"evidence":{"kind":"docs","sources":["s1","s6"],"confidence":"high"}},{"id":"quota-extension-request","title":"Request a quota extension in the Dashboard","actor":"you","stage":"launch","time":{"min":1,"max":4,"unit":"hours"},"detail":"Once your Partner Application is approved, open the app's Settings and go to the Quota extension Request tab. Complete the four-step questionnaire and submit. The app page then shows 'Sent'.","actions":["Open the app, then Settings, then Quota extension Request","Complete the four-step questionnaire","Click Submit"],"agentNote":"An agent can fill in the questionnaire. A person reviews and submits it.","link":{"label":"Spotify Developer Dashboard","url":"https://developer.spotify.com/dashboard"},"image":{"url":"https://developer-assets.spotifycdn.com/images/documentation/web-api/request-a-quota-extension.png","alt":"Request Extension link","source":"s1"},"evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"id":"spotify-review","title":"Wait for Spotify's compliance review","actor":"provider","stage":"launch","time":{"min":0,"max":6,"unit":"weeks"},"detail":"Spotify checks the app against its Developer Policy and emails the result to the account address. The docs say this takes up to six weeks.","gotcha":"Spotify doesn't guarantee approval even when you meet the criteria.","evidence":{"kind":"docs","sources":["s1","s6"],"confidence":"medium"}}],"blockers":[{"symptom":"403 errors for users other than you","cause":"The app is in development mode and the user isn't on the allowlist, or the 5-user cap is full.","fix":"Add the user under Users and Access. To go past 5 users you need extended quota.","evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"symptom":"App suddenly stops working","cause":"The owner's Premium subscription lapsed. Development-mode apps require it.","fix":"Renew Premium on the owner account.","evidence":{"kind":"docs","sources":["s3"],"confidence":"high"}},{"symptom":"INVALID_CLIENT: Invalid redirect URI","cause":"The redirect URI uses localhost, uses plain HTTP on a non-loopback host, or doesn't exactly match a registered URI.","fix":"Register an exact HTTPS URI or a 127.0.0.1 or [::1] loopback URI.","evidence":{"kind":"docs","sources":["s4"],"confidence":"medium"}},{"symptom":"Can't get extended quota as a solo developer or startup","cause":"Since May 15, 2025, only registered businesses with at least 250k MAU are eligible.","fix":"No workaround. Stay within 5 users, or apply once you meet the criteria.","evidence":{"kind":"community","sources":["s1","s6","s7"],"confidence":"high"}},{"symptom":"Endpoints return errors or fields are missing in development mode","cause":"The February 2026 changes removed batch endpoints, browse, other users' data and some response fields from development-mode apps.","fix":"Use the replacement endpoints, such as /me/library and /items, or get extended quota.","evidence":{"kind":"docs","sources":["s3"],"confidence":"high"}}],"unknowns":[{"question":"How long does the Partner Application take to process?","why":"The docs give six weeks for the quota review only. Nothing covers the Partner Application step.","resolve":"Ask in the Spotify for Developers community forum or contact Spotify partner support."},{"question":"Do restricted endpoints stay restricted for existing development-mode apps?","why":"A staff forum post reportedly postponed the endpoint changes for existing apps, but the migration guide doesn't mention a postponement.","resolve":"Check the February 2026 update thread on community.spotify.com and the migration guide's changelog."}],"handoff":{"agentCan":["Fill in the Create app form and redirect URIs","Copy the client ID into your OAuth client","Add allowlisted users","Test the OAuth flow","Draft answers for the Partner Application and quota extension"],"youMust":["Sign in with a Spotify Premium account","Accept the Developer Terms","Handle the client secret","Submit the Partner Application from a company email","Submit the quota extension request and respond to Spotify's emails"]},"sources":[{"id":"s1","title":"Quota modes","url":"https://developer.spotify.com/documentation/web-api/concepts/quota-modes","publisher":"Spotify for Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s2","title":"Apps","url":"https://developer.spotify.com/documentation/web-api/concepts/apps","publisher":"Spotify for Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s3","title":"February 2026 Web API Dev Mode Changes - Migration Guide","url":"https://developer.spotify.com/documentation/web-api/tutorials/february-2026-migration-guide","publisher":"Spotify for Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s4","title":"Redirect URIs","url":"https://developer.spotify.com/documentation/web-api/concepts/redirect_uri","publisher":"Spotify for Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s5","title":"Update on Developer Access and Platform Security","url":"https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security","publisher":"Spotify for Developers blog","kind":"search","checkedAt":null},{"id":"s6","title":"Updating the Criteria for Web API Extended Access (forum thread)","url":"https://community.spotify.com/t5/Spotify-for-Developers/Updating-the-Criteria-for-Web-API-Extended-Access/td-p/6920661/page/8","publisher":"Spotify Community","kind":"search","checkedAt":null},{"id":"s7","title":"Request Production OAuth Access (Not Extended Quota)","url":"https://community.spotify.com/t5/Spotify-for-Developers/Request-Production-OAuth-Access-Not-Extended-Quota/td-p/7354560","publisher":"Spotify Community","kind":"search","checkedAt":null},{"id":"s8","title":"Composio managed auth toolkits","url":"https://docs.composio.dev/toolkits/managed-auth.md","publisher":"Composio docs","kind":"composio","checkedAt":null}],"feedback":{}}