Single Sign-On (SSO)

Customize how your team can login to Mintlify

Mintlify supports single sign-on to your dashboard via SAML and OIDC. If you use Okta or Google Workspace, we have provider-specific documentation for setting up SSO, but if you use another provider, please contact us!

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

Okta

• SAML
• OIDC

1

Create an application

Under Applications, click to create a new app integration using SAML 2.0.

2

Configure integration

Enter the following:

• Single sign-on URL (provided by Mintlify)
• Audience URI (provided by Mintlify)
• Name ID Format: EmailAddress
• Attribute Statements:

  Name	Name format	Value
  firstName	Basic	user.firstName
  lastName	Basic	user.lastName

3

Send us your IdP information

Once the application is set up, navigate to the sign-on tab and send us the metadata URL. We’ll enable the connection from our side using this information.

Google Workspace

• SAML

1

Create an application

Under Web and mobile apps, select Add custom SAML app from the Add app dropdown.

2

Send us your IdP information

Copy the provided SSO URL, Entity ID, and x509 certificate and send it to the Mintlify team.

3

Configure integration

On the Service provider details page, enter the following:

• ACS URL (provided by Mintlify)
• Entity ID (provided by Mintlify)
• Name ID format: EMAIL
• Name ID: Basic Information > Primary email

On the next page, enter the following attribute statements:

Google Directory Attribute	App Attribute
First name	firstName
Last name	lastName

Once this step is complete and users are assigned to the application, let our team know and we’ll enable SSO for your account!