Logto Experience API

Verify enterprise SSO verification

POST /api/experience/verification/sso/{connectorId}/verify

Verify the SSO authorization response data and get the user's identity from the SSO provider.

Path parameters

  • connectorId string Required

    The unique identifier of the connector.

application/json

Body Required

  • connectorData object Required

    Arbitrary data returned by the SSO provider to complete the verification process.

  • verificationId string Required

    The ID of the EnterpriseSSO verification record.

Responses

  • 200 application/json

    The SSO authorization response has been successfully verified.

    Hide response attribute Show response attribute object
    • verificationId string Required

      The current verified EnterpriseSSO verification record ID. This ID is required when identifying the user in the current interaction.
  • 400

    The SSO authorization response is invalid or cannot be verified.

  • 404

    The verification record or the SSO connector is not found.

  • 500

    Connector error. Failed to verify the SSO authorization response or fetch the user info from the SSO provider.

POST /api/experience/verification/sso/{connectorId}/verify 
curl \
 --request POST 'https://[tenant_id].logto.app/api/experience/verification/sso/{connectorId}/verify' \
 --header "Content-Type: application/json" \
 --data '{"connectorData":{},"verificationId":"string"}'
Request examples 
{
  "connectorData": {},
  "verificationId": "string"
}
Response examples (200) 
{
  "verificationId": "string"
}