Claiming a Neon Auth project

Neon Auth is powered by Stack Auth under the hood. By default, Neon manages your authentication for you, so you do not typically need to interact with Stack Auth directly. However, there are cases where you may want to take direct control of your authentication project in the Stack Auth dashboard.

Why claim a project?

Most Neon Auth features can be built using the SDKs, without claiming your project.

Right now, you need to claim your project if you want to:

• Add or manage OAuth providers (register client IDs/secrets, set callback URLs)
• Use your own SMTP server for auth emails
• Enable production mode and enforce production security settings
• Manage multiple projects or separate production and development environments directly in Stack Auth

1. Claim via the Neon Console

   1. Go to your project's Auth page in the Neon Console.
   2. Click Transfer ownership.
   3. Follow the prompts to select the Stack Auth account that should receive ownership.

   After claiming, you'll have direct access to manage your project in the Stack Auth dashboard, while maintaining the integration with your Neon database.

2. Claim via the API

   You can also claim your project programmatically:

   curl --request POST \
        --url 'https://console.neon.tech/api/v2/projects/auth/transfer_ownership' \
        --header 'authorization: Bearer $NEON_API_KEY' \
        --data '{
          "project_id": "project-id",
          "auth_provider": "stack"
        }'

   Open the returned URL in your browser to complete the claim process.
   See Neon Auth API Reference for more details.

   note

   After claiming, you'll still be able to access your project from the Neon Console, but you'll also have direct access from the Stack Auth dashboard.