IdP Redirect with SAML Deep Link not Working - Error "404 Page Not Found"
Jun 3, 2025
Single Sign-On
Okta Classic Engine
Okta Identity Engine
Overview
SAML deep link is unable to redirect the user to an app after successfully authenticating with a third-party IdP and returns with an error:
404 Page Not Found.
Applies To
- SAML IdP Deep Link
- API SAML IdP Deep Link
- Secure Assertion Markup Language (SAML)
Cause
The SAML IdP deep link is in three parts: https://${YourOktaDomain}/sso/saml2/:idpId/app/:app-location/:appId/sso/saml?RelayState=:anyUrlEncodedValue.
Deep link returns with Error 404 Page Not Found, mostly in cases where the app location is incorrect.
Solution
Please ensure that :IdPId and the :app-location values are correct.
The app-location value can be found from the Okta Admin Dashboard > Applications > Applications > Desired App > General tab > Embed Link:
Example:
