Skip to main content
POST
Register application
Call this endpoint with the verified account session created during user account setup. That session is the bootstrap path for the first application, so no existing API key is required. A user-scoped OAuth grant or compatible user-bound key can also manage applications. See the Developer guide for the complete endpoint and credential map. Registering an application does not authorize access to an end user; that requires their scoped Darwin OAuth grant.

Authorizations

__Secure-better-auth.session_token
string
cookie
required

The HTTP-only Darwin account session cookie set after sign-in. Local development uses better-auth.session_token without the __Secure- prefix.

Body

application/json
name
string
required
Required string length: 1 - 160
description
string
Maximum string length: 5000
websiteUrl
string<uri>
redirectUris
string<uri>[]
Maximum array length: 50
metadata
object

Response

The application was registered.

application
object
required
Last modified on October 4, 2026