You’re viewing the v2 beta documentation. The API is in active development - breaking changes may occur before final release. For production use, switch to v1 using the version selector above.
SSO configuration is available to Admin roles only. You can find it under the user menu → SSO Configuration.
Requirements
- You must be signed in with a corporate email address. Public email domains (e.g., gmail.com, yahoo.com) are not supported for SSO.
- You will need access to your identity provider’s admin console to complete the setup.
- Have your IdP’s SAML metadata URL or XML ready before starting.
Setting Up SSO
Step 1: Open SSO Configuration
Navigate to SSO Configuration from the user menu in the top-right corner of the dashboard.Step 2: Start Setup
Click Start SSO Setup. This opens a setup portal in a new browser tab where you can connect your identity provider.Step 3: Configure Your Identity Provider
In the setup portal, you will:- Select your identity provider — Choose from supported providers like Okta, Azure AD, Google Workspace, and others.
- Upload SAML metadata — Paste your IdP’s SAML metadata URL or upload the metadata XML file.
- Verify the connection — Complete the setup and test that authentication works correctly.
Page States
The SSO Configuration page reflects the current state of your setup:| State | What You See |
|---|---|
| Not configured | Description of SSO and a Start SSO Setup button |
| Setup in progress | Your organization name, setup instructions, and an Open Setup Portal button to complete IdP configuration |
| SSO active | A success banner showing the connected IdP type, with an option to reopen the portal for changes |
Updating SSO Configuration
After SSO is active, you can update your identity provider settings at any time by clicking Open Setup Portal on the SSO Configuration page. This generates a new portal link where you can modify or replace your IdP connection.Next Steps
Authentication
Learn about API key authentication
Management UI
Manage members, API keys, and more