Single Sign-On (SSO)

Customize how your team can login to Mintlify

Mintlify supports Single Sign-On (SSO) via SAML and OIDC. We offer specific setup guides for Okta and Google Workspace users.

SSO is available on our Enterprise plan. Contact us to learn more!

Okta

• SAML
• OIDC

1

Create application

Create a new app integration using SAML 2.0 under Applications.

2

Configure

Configure with:

• Single sign-on URL (from Mintlify)
• Audience URI (from Mintlify)
• Name ID Format: EmailAddress
• Required attributes: firstName and lastName

3

Complete setup

Share your metadata URL with us to complete the integration.

1

Create application

Create a new app integration using SAML 2.0 under Applications.

2

Configure

Configure with:

• Single sign-on URL (from Mintlify)
• Audience URI (from Mintlify)
• Name ID Format: EmailAddress
• Required attributes: firstName and lastName

3

Complete setup

Share your metadata URL with us to complete the integration.

1

Create application

Create a new OIDC Web Application under Applications.

2

Configure

Set up authorization code grant type with Mintlify’s Redirect URI.

3

Complete setup

Share your client ID, client secret, and Okta instance URL with us securely.

Google Workspace

• SAML

1

Create application

Add a custom SAML app under Web and mobile apps.

2

Share IdP details

Provide us with your SSO URL, Entity ID, and x509 certificate.

3

Configure

Enter the following:

• ACS URL and Entity ID (from Mintlify)
• Name ID format: EMAIL
• Name ID: Basic Information > Primary email
• Attributes: Map First name to firstName and Last name to lastName

After user assignment is complete, we’ll enable SSO for your account.

1

Create application

Add a custom SAML app under Web and mobile apps.

2

Share IdP details

Provide us with your SSO URL, Entity ID, and x509 certificate.

3

Configure

Enter the following:

• ACS URL and Entity ID (from Mintlify)
• Name ID format: EMAIL
• Name ID: Basic Information > Primary email
• Attributes: Map First name to firstName and Last name to lastName

After user assignment is complete, we’ll enable SSO for your account.