Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Link a secondary email/SMS identity to your account

Link an additional (secondary) email or SMS identity to your existing account.

Primary vs Secondary Identities:

  • Your PRIMARY identity was set during signup via /auth/exchange-cdp-token
  • This endpoint adds SECONDARY identities for backup login and account recovery
  • Secondary identities can be used to login via /auth/login/start or recover via /auth/recover/start

Flow:

  1. Authenticate with CDP SDK using a NEW email/phone (not your primary)
  2. CDP returns an access token
  3. Call this endpoint with the CDP token to link as a secondary identity

Note: The identity must not already be linked to another account. Account merging is not yet supported.

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/identities/verify

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Request body

cdp_tokenstring required

CDP Auth token to verify and extract identity from

Response

Successful Response

idstring required

Identity ID

identity_typestring required

Type of identity (email, sms, evm, solana, ens, etc.)

identity_valuestring required

The identity value (email address, wallet address, ENS name, etc.)

resolved_addressstring nullable

For ENS identities: the resolved wallet address

verified_atstring nullable

When the identity was verified (ISO 8601)

verification_methodstring nullable

How the identity was verified (otp, signature, ens_lookup, etc.)

is_primaryboolean required

Whether this is the primary identity (primary cannot be deleted)

created_atstring required

When the identity was created (ISO 8601)