# 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 parameters
Content-type: application/json

- **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 Parameters: 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)