Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
auth

Complete login with credential

Complete the login flow by providing the credential for the selected auth method.

For email/SMS (cdp_otp):

  1. Use CDP SDK to authenticate with the identity shown in login/start
  2. Provide the CDP token in cdp_token field
  3. Provide the exact identity_value you authenticated with

For wallet (signature):

  1. Sign the challenge message from login/start with your wallet
  2. Provide the signature in signature field
  3. Provide the exact identity_value (wallet address) you are signing with

On success, returns the Grove API key (JWT).

post/v1/auth/login/complete

Request body

login_tokenstring required

Signed session token from login/start

auth_method_typestring required

Selected authentication method type (email, sms, evm, solana)

identity_valuestring required

Exact identity value for the selected method (email, phone, or wallet address)

cdp_tokenstring nullable

CDP Auth token (for email/SMS OTP auth)

signaturestring nullable

Wallet signature of challenge message (for wallet auth)

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