Sign in
Auth (legacy)

Create new auth user

Deprecated. Use /projects/{project_id}/branches/{branch_id}/auth/users instead. Removal scheduled for March 1, 2026. The user will be created in your neon_auth.users_sync table and automatically propagated to your auth project, whether Neon-managed or provider-owned.

post/projects/auth/user

Request

  • Base URL: https://console.neon.tech/api/v2
  • URL: https://console.neon.tech/api/v2/projects/auth/user
  • Auth: one of:
    • HTTP bearer
    • API key in cookie zenith
    • API key in cookie keycloak_token

Request body

project_idstring required

The Neon project ID. Returned as id from GET /projects.

auth_provider'mock' | 'stack' | 'better_auth' required

Authentication provider integrated with this Neon Auth configuration. better_auth integrates with Better Auth (the current, recommended provider). stack integrates with Stack Auth (deprecated). mock is a simulated provider for local development and testing only.

emailstring email required

Email address of the new user.

namestring

Display name for the new user. When omitted, the created user has no display name.

Response

Creates new user

idstring required

ID of newly created user

Changes

No recorded changes to this operation across all 15 revisions of this API.