Mark the identity-linking onboarding step complete

Idempotent. Sets onboarding.identities_completed_at on the authenticated account if not already set, then returns the standard account snapshot with the updated onboarding state.

The frontend calls this when the user finishes /welcome/profiles. A second call is a no-op — the stored timestamp is not overwritten.

Authentication: Authorization: Bearer <CLIENT_JWT>.

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Response

Successful Response

account_idstring required

tipping_addressstring required

earning_addressstring nullable

eoa_owner_addressstring nullable

smart_account_addressstring nullable

ERC-4337 Smart Account address (the earning wallet)

external_linked_walletsstring[]

External linked wallet addresses (profile references, non-earning)

networkstring required

metadataobject nullable

handlestring nullable

referral_codestring required

referred_by_account_idstring nullable

referral_countinteger

onchain_addressstring required

embedded_wallet_addressstring nullable required

client_addressstring nullable required

earnings_addressstring nullable required

v1

Mark the identity-linking onboarding step complete

Headers

Response