Verifications

Create a social verification record

Create a social verification record and return the authorization URI.

post/api/verifications/social

Request

  • Base URL: https://[tenant_id].logto.app
  • URL: https://[tenant_id].logto.app/api/verifications/social
  • Auth: OAuth 2 (client credentials, token URL /oidc/token, scopes: all)

Request body

statestring required

A random string generated on the client side to prevent CSRF (Cross-Site Request Forgery) attacks.

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

scopestring

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.

connectorIdstring required

The Logto connector ID.

Response

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

verificationRecordIdstring required

The ID of the verification record.

authorizationUristring required

The authorization URI to navigate to for authentication and authorization in the connected social identity provider.

expiresAtstring required

The expiration date and time of the verification record.

Changes

No recorded changes to this operation across all 8 revisions of this API.