Verify Instagram social link

Verify ownership of an Instagram social link using a Facebook OAuth 2.0 access token with instagram_basic scope.

Flow:

Client obtains a Facebook OAuth 2.0 access token via authorization code flow with instagram_basic scope
Client sends the token to this endpoint
API calls Instagram Graph API to get the authenticated user's Instagram username
If the username matches the account's stored Instagram link, it's marked as verified

Prerequisites:

Account must have an Instagram social link already added (via POST /v1/account/social-links)
Client must have a valid Facebook OAuth 2.0 access token with instagram_basic scope
User's Instagram account must be linked to their Facebook account

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

Authentication: Authorization: Bearer <CLIENT_JWT>

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Request body

access_tokenstring required

Facebook OAuth 2.0 access token with instagram_basic scope

Successful Response

verifiedboolean required

Whether the Instagram link is now verified

platformstring

Platform that was verified

usernamestring required

Instagram username from Graph API

verification_methodstring required

Method used for verification