v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
verification

Verify Twitch social link

Verify ownership of a Twitch social link using an OAuth 2.0 access token.

Flow:

  1. Client obtains a Twitch OAuth 2.0 access token via authorization code flow
  2. Client sends the token to this endpoint
  3. API validates the token against Twitch's GET /helix/users endpoint
  4. If the returned username matches the account's existing Twitch social link, it's marked as verified

Prerequisites:

  • Account must have a Twitch social link already added (via POST /v1/account/social-links)
  • Client must have a valid Twitch OAuth 2.0 access token

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

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/social/verify/twitch

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Request body

access_tokenstring required

Twitch OAuth 2.0 access token obtained via authorization code flow

Response

Successful Response

verifiedboolean required

Whether the Twitch link is now verified

platformstring

Platform that was verified

usernamestring required

Twitch username that was verified

verification_methodstring required

Method used for verification