[PR #7075] [MERGED] docs: update Spotify provider guide to use 127.0.0.1 #7059

Closed
opened 2026-03-13 13:22:47 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/7075
Author: @Proxyy587
Created: 12/31/2025
Status: Merged
Merged: 1/1/2026
Merged by: @himself65

Base: canaryHead: canary


📝 Commits (3)

  • 6a3add9 docs: update spotify redirect uri to 127.0.0.1
  • cb15f11 docs: update spotify redirect uri to 127.0.0.1
  • 345581d docs: corrected spotify better auth url env markdown

📊 Changes

1 file changed (+15 additions, -3 deletions)

View changed files

📝 docs/content/docs/authentication/spotify.mdx (+15 -3)

📄 Description

Description

Updates the Spotify provider documentation to strictly use 127.0.0.1 instead of localhost.

Changes include:

  1. Updating the Spotify Dashboard setup instructions to use http://127.0.0.1:3000/....
  2. Adding a required step to set BETTER_AUTH_URL=http://127.0.0.1:3000 in the .env file.
  3. Adding a warning to access the local app via the loopback IP address.

Why this is needed

Spotify has updated their developer policy and now strictly enforces the use of 127.0.0.1 for local development redirect URIs. localhost is no longer permitted as a valid Redirect URI in the Spotify Developer Dashboard.

Without these changes (specifically the matching BETTER_AUTH_URL and Dashboard URI), users following the current documentation will encounter an INVALID_REDIRECT_URI error during authentication.

References


Summary by cubic

Update the Spotify provider guide to require 127.0.0.1 instead of localhost for local redirect URIs. Adds an .env step (BETTER_AUTH_URL=http://127.0.0.1:3000) and a note to open the app at http://127.0.0.1:3000 to avoid INVALID_REDIRECT_URI.

Written for commit 345581dd70. Summary will update on new commits.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/better-auth/better-auth/pull/7075 **Author:** [@Proxyy587](https://github.com/Proxyy587) **Created:** 12/31/2025 **Status:** ✅ Merged **Merged:** 1/1/2026 **Merged by:** [@himself65](https://github.com/himself65) **Base:** `canary` ← **Head:** `canary` --- ### 📝 Commits (3) - [`6a3add9`](https://github.com/better-auth/better-auth/commit/6a3add9b654614b6af01bdc3a9ba9121b4b8af3a) docs: update spotify redirect uri to 127.0.0.1 - [`cb15f11`](https://github.com/better-auth/better-auth/commit/cb15f11bbbab6426c0e6188c429816395bbcda4c) docs: update spotify redirect uri to 127.0.0.1 - [`345581d`](https://github.com/better-auth/better-auth/commit/345581dd70156a806a86f27358363b3d49d7f936) docs: corrected spotify better auth url env markdown ### 📊 Changes **1 file changed** (+15 additions, -3 deletions) <details> <summary>View changed files</summary> 📝 `docs/content/docs/authentication/spotify.mdx` (+15 -3) </details> ### 📄 Description ## Description Updates the Spotify provider documentation to strictly use `127.0.0.1` instead of `localhost`. **Changes include:** 1. Updating the **Spotify Dashboard** setup instructions to use `http://127.0.0.1:3000/...`. 2. Adding a required step to set `BETTER_AUTH_URL=http://127.0.0.1:3000` in the `.env` file. 3. Adding a warning to access the local app via the loopback IP address. ## Why this is needed Spotify has updated their developer policy and now strictly enforces the use of `127.0.0.1` for local development redirect URIs. `localhost` is no longer permitted as a valid Redirect URI in the Spotify Developer Dashboard. Without these changes (specifically the matching `BETTER_AUTH_URL` and Dashboard URI), users following the current documentation will encounter an `INVALID_REDIRECT_URI` error during authentication. ## References - **Spotify Developer Documentation (App Settings):** https://developer.spotify.com/documentation/web-api/concepts/apps *(See section: "Redirect URIs" -> "Requirements")* <img width="1071" height="685" alt="Screenshot 2025-12-31 at 11 43 15 PM" src="https://github.com/user-attachments/assets/2beca990-938b-463e-b99d-4b5cb074420f" /> <!-- This is an auto-generated description by cubic. --> --- ## Summary by cubic Update the Spotify provider guide to require 127.0.0.1 instead of localhost for local redirect URIs. Adds an .env step (BETTER_AUTH_URL=http://127.0.0.1:3000) and a note to open the app at http://127.0.0.1:3000 to avoid INVALID_REDIRECT_URI. <sup>Written for commit 345581dd70156a806a86f27358363b3d49d7f936. Summary will update on new commits.</sup> <!-- End of auto-generated description by cubic. --> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-03-13 13:22:47 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/better-auth#7059