RingCentral IdP-Initiated SSO Shows "Unexpected Error"
Jan 8, 2026
Single Sign-On
Okta Identity Engine
Overview
This article provides information on how to troubleshoot the following error that may occur when attempting to authenticate into RingCentral via Identity Provider (IdP) initiated Single Sign-On (SSO) flow, which happens upon clicking the tile in the Okta dashboard.
Unexpected Error
Sorry for the inconvenience. Please contact your administrator to provide the reference number below in order to find the corresponding error.
Applies To
- RingCentral
- Single Sign-On (SSO)
- Identity Provider (IdP)
- Okta Identity Engine
Cause
The Default Relay State in the RingCentral Application template located in the Okta Integration Catalogue is not set to the correct value.
Solution
Ensure the Default Relay State for the Ring Central application in Okta is configured as recommended in How to Configure SAML 2.0 for RingCentral.
Default Relay State:
https://service.ringcentral.com/mobile/ssoLogin
Steps to Configure
- Access the Okta Admin Console
- Navigate to the Ring Central application via Applications > Applications
- Click the Authenticate tab
- Click Edit in the Sign-on settings section to review the SAML 2.0 configuration
- Enter the relevant value for the Default Relay State (see Related References below)
- Click Save
