Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
claim

Sign in or claim via Facebook

Authenticate with a Facebook identity. Handles both login and auto-claim in a single call:

  • If the Facebook identity is verified on an existing account → login
  • If the Facebook identity is unverified on a pre-registered account → auto-claim
  • If no matching account exists → 404 (call /register with email + handle)

Rate-limited per client IP.

post/v1/auth/social/facebook

Request body

access_tokenstring required

Platform OAuth access token obtained client-side

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