Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Neon Auth

Neon Auth is a managed authentication service built on Better Auth that connects directly to a Neon Postgres database. It stores authentication data including users, sessions, and OAuth configurations in the database's neon_auth schema. Neon Auth provides client and server SDKs, supports multiple OAuth providers, and integrates with the Neon Data API for automatic JWT validation. It enables Row-Level Security policies through the auth.uid() function, allowing developers to implement fine-grained data access control based on authenticated users.

Neon Auth is one of 13 APIs that Neon publishes on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include Authentication, Authorization, OAuth, JWT, and Security. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

This event API exposes 1 operation across 1 channel, and defines 6 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.

The API connects through a single server, {webhookUrl} (https).

1 operations 1 channels 6 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0
Server
{webhookUrl} (https)
Resource Areas
1

Channels & Operations 1

Across 1 channel, the API surfaces 1 operation. Each is listed below with its action, channel, parameters, and response codes.

Channels 1
PUB
/webhook
Receive authentication webhook events
receiveAuthWebhookEvent body

Messages & Schemas 6

The contract defines 6 schemas that model the data carried by its messages. The most detailed are MagicLinkDeliveryPayload (6 properties), OtpDeliveryPayload (5 properties), UserCreatedPayload (3 properties). Each schema is shown below with its type and property counts.

OtpDeliveryEvent
message
Sent when an OTP code needs to be delivered to a user for email verification or two-factor authentication.
MagicLinkDeliveryEvent
message
Sent when a magic link needs to be delivered to a user for passwordless authentication.
UserCreatedEvent
message
Sent when a new user account is created through Neon Auth.
OtpDeliveryPayload
object
Payload for OTP delivery webhook events containing the OTP code and recipient information.
5 properties 3 required
MagicLinkDeliveryPayload
object
Payload for magic link delivery webhook events containing the magic link URL and recipient information.
6 properties 3 required
UserCreatedPayload
object
Payload for user created webhook events containing the new user information.
3 properties 2 required

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

neon-auth-webhooks-asyncapi.yml Raw ↑

Other APIs Neon publishes across the network.

Neon Data API
Neon Serverless Driver
Neon API Keys API
Neon Auth API
Neon Branches API
Neon Consumption API
Neon Data API API
Neon Databases API
Neon Endpoints API
Neon Operations API
Neon Projects API
Neon Roles API