---
title: "Create a social verification record"
method: POST
path: "/api/verifications/social"
tags: ["Verifications"]
---

# Create a social verification record

`POST /api/verifications/social`

Create a social verification record and return the authorization URI.

## Request body

- object
  - `state` string, required — A random string generated on the client side to prevent CSRF (Cross-Site Request Forgery) attacks.
  - `redirectUri` string, required — The URI to navigate back to after the user is authenticated by the connected social identity provider and has granted access to the connector.
  - `scope` string — The custom scopes of the social verification. It can be used to request specific permissions from the social identity provider. If provided, it will override the scope configured in the connector settings.
  - `connectorId` string, required — The Logto connector ID.

## Response `201`

Successfully created the social verification record and returned the authorization URI.

- object
  - `verificationRecordId` string, required — The ID of the verification record.
  - `authorizationUri` string, required — The authorization URI to navigate to for authentication and authorization in the connected social identity provider.
  - `expiresAt` string, required — The expiration date and time of the verification record.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The connector specified by connectorId is not found.
- `422` — The connector specified by connectorId is not a valid social connector.

---

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