v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
verification

Verify Facebook social link

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

Flow:

  1. Client obtains a Facebook OAuth 2.0 access token via authorization code flow
  2. Client sends the token to this endpoint
  3. API validates the token against Facebook's Graph API and retrieves the user's profile ID
  4. Compares the Facebook numeric ID against the stored social link URL to prevent verifying someone else's profile
  5. If valid, the account's Facebook social link is marked as verified

Prerequisites:

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

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

Authentication: Authorization: Bearer <CLIENT_JWT>

post/v1/account/social/verify/facebook

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

Facebook OAuth 2.0 access token obtained via authorization code flow

Response

Successful Response

verifiedboolean required

Whether the Facebook link is now verified

platformstring

Platform that was verified

namestring required

Facebook display name from Graph API

verification_methodstring required

Method used for verification