GRgrove
verification

Verify TikTok social link

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

Flow:

  1. Client obtains a TikTok OAuth 2.0 access token via authorization code flow
  2. Client sends the token to this endpoint
  3. API validates the token against TikTok's POST /v2/user/info/ endpoint
  4. If the returned profile matches the account's existing TikTok social link, it's marked as verified

Prerequisites:

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

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

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/social/verify/tiktok

Request

  • Base URL
    https://api.grove.city (the document declares no server; this is the origin it was published from)
  • URL
    https://api.grove.city/v1/account/social/verify/tiktok
  • Auth
    none declared

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Request body

access_tokenstring required

TikTok OAuth 2.0 access token obtained via authorization code flow

Response

Successful Response

verifiedboolean required

Whether the TikTok link is now verified

platformstring

Platform that was verified

usernamestring required

TikTok username that was verified

verification_methodstring required

Method used for verification

Changes

No recorded changes to this operation across all 1 revision of this API.