# Create a social verification record

**POST /api/verifications/social**

Create a social verification record and return the authorization URI.


## Servers
- Logto endpoint address.: https://[tenant_id].logto.app (Logto endpoint address.)


## Authentication methods
- O auth2


## Parameters



### Body: application/json (object)

- **state** (string)
  A random string generated on the client side to prevent CSRF (Cross-Site Request Forgery) attacks.
- **redirectUri** (string)
  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)
  The Logto connector ID.


## Responses
### 201
Successfully created the social verification record and returned the authorization URI.

#### Body: application/json (object)
- **verificationRecordId** (string)
  The ID of the verification record.
- **authorizationUri** (string)
  The authorization URI to navigate to for authentication and authorization in the connected social identity provider.
- **expiresAt** (string)
  The expiration date and time of the verification record.

### 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.


[Powered by Bump.sh](https://bump.sh)