Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
claim

Register a new account via YouTube OAuth

Create a new Grove account by proving YouTube ownership + providing an email and handle.

Intended flow:

  1. Call POST /v1/auth/social/youtube first
  2. If 404 (no existing account), call this endpoint with the same OAuth token plus the user's email and desired handle

The OAuth token proves social identity ownership — no separate OTP is needed. The email becomes the account's primary identity. The YouTube identity is attached and marked verified.

Rate-limited per client IP.

post/v1/auth/social/youtube/register

Request body

access_tokenstring required

Platform OAuth access token obtained client-side

emailstring required

User's email address (required for account creation)

handlestring required

Desired Grove handle (case-insensitive, alphanumeric + underscores)

Example request

{
  "email": "artist@example.com",
  "handle": "alice"
}

Response

Successful Response

account_idstring required

Account ID

api_keystring required

Grove API key (JWT)

identity_typestring required

Primary identity type

identity_valuestring required

Primary identity value

tipping_addressstring required

Server wallet address (for tipping)

onchain_addressstring required