---
title: "Verify Facebook social link"
method: POST
path: "/v1/account/social/verify/facebook"
tags: ["verification"]
---

# Verify Facebook social link

`POST /v1/account/social/verify/facebook`

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>`

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove that identifies the account.

## Request body

- FacebookVerifyRequest — Request model for POST /v1/account/social/verify/facebook. The client obtains a Facebook OAuth 2.0 access token via authorization code flow, then sends it here for server-side validation against Facebook's Graph API.
  - `access_token` string, required — Facebook OAuth 2.0 access token obtained via authorization code flow

## Response `200`

Successful Response

- FacebookVerifyResponse — Response model for POST /v1/account/social/verify/facebook.
  - `verified` boolean, required — Whether the Facebook link is now verified
  - `platform` string — Platform that was verified
  - `name` string, required — Facebook display name from Graph API
  - `verification_method` string, required — Method used for verification

## Other responses

- `400` — Invalid access token, no Facebook link, or profile ID mismatch
- `401` — Missing or invalid Grove JWT
- `422` — Validation Error
- `502` — Facebook API unavailable

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/revisions/f286b48a8105/schema)