Path of Exile 2 Toolkit - Setup Guide

⚠️ OAuth Setup Required

To use this toolkit with your Path of Exile account, you need to register it as an OAuth application. This is a one-time setup that enables secure access to your account data.

Step 1: Register Your OAuth Application

Visit the Path of Exile Developer Portal:https://www.pathofexile.com/developer/docs
Log in with your Path of Exile account
Navigate to "My Applications" or "Create Application"
Create a new OAuth application with these settings:
Application Name:PoE2 Toolkit (or your choice)
Grant Type:Authorization Code with PKCE
Redirect URI:http://localhost:3000/auth/callback
Scopes Required:
- ✓ account:profile
- ✓ account:characters
- ✓ account:stashes (optional)
After creating the application, copy your Client ID
Note: Public clients using PKCE don't need a client secret

Step 2: Configure Environment Variables

Update your .env.local file with your credentials:

# Replace with your registered Client ID from Path of Exile
NEXT_PUBLIC_POE_CLIENT_ID=your_actual_client_id_here

# Keep this as is for local development
NEXT_PUBLIC_POE_REDIRECT_URI=http://localhost:3000/auth/callback

Important: After updating the .env.local file, you need to restart the development server:

# Stop the server (Ctrl+C) and restart:
npm run dev

Step 3: Test Your Setup

Once you've configured your OAuth credentials and restarted the server, you can test the authentication:

Go to Login Page

Troubleshooting

"invalid_client" error

This means your client ID is not set correctly. Make sure you've copied the exact client ID from Path of Exile and added it to your .env.local file.

"redirect_uri_mismatch" error

The redirect URI in your Path of Exile app settings must exactly match: http://localhost:3000/auth/callback

Environment variables not loading