Create a social verification record

POST /api/verifications/social
OAuth2

Create a social verification record and return the authorization URI.

application/json

Body Required

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

  • connectorId string Required

    The Logto connector ID.

Responses

  • 201 application/json

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

    Hide response attributes Show response attributes 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.
  • 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.

POST /api/verifications/social 
curl \
 -X POST https://[tenant_id].logto.app/api/verifications/social \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"state":"string","redirectUri":"string","connectorId":"string"}'
Request examples 
{
  "state": "string",
  "redirectUri": "string",
  "connectorId": "string"
}
Response examples (201) 
{
  "verificationRecordId": "string",
  "authorizationUri": "string",
  "expiresAt": "string"
}