Verify YouTube social link

Verify ownership of a YouTube social link using a Google OAuth 2.0 access token.

Flow:

Client obtains a Google OAuth 2.0 access token via PKCE flow (youtube.readonly scope)
Client sends the token to this endpoint
API validates the token against YouTube's GET /v3/channels?mine=true endpoint
If the returned channel matches the account's existing YouTube social link, it's marked as verified

Prerequisites:

Account must have a YouTube social link already added (via POST /v1/account/social-links)
Client must have a valid Google OAuth 2.0 access token with youtube.readonly scope

Idempotent: Calling this on an already-verified YouTube link returns success.

Authentication: Authorization: Bearer <CLIENT_JWT>

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Request body

access_tokenstring required

Google OAuth 2.0 access token obtained via PKCE flow with youtube.readonly scope

Successful Response

verifiedboolean required

Whether the YouTube link is now verified

platformstring

Platform that was verified

channel_namestring required

YouTube channel name that was verified

verification_methodstring required

Method used for verification