Set up Auth0 SSO

Last updated: October, 2026

You can now integrate Circle with Auth0, making it a seamless experience for your Auth0 members to log in to your community!

Once Auth0 is implemented, members won't have to sign up or log in with their Circle account — instead, they'll use Auth0 credentials and access Circle from your login page.

1. If you plan to use a custom domain, set that up first, as this will change your Callback URL. Not doing this first can potentially lead to being locked out of your account.

2. We recommend keeping the Allow members with a Circle account to sign in toggle enabled in the community’s SSO settings to avoid getting locked out of your account while setting up your SSO integration. In case this happens, you can easily sign in again with your Circle credentials.

3. In case you would like to turn off the Circle Sign in completely, please make sure to add your community admin account email as a user in Auth0. Upon login, Circle will automatically sync your admin email account with your Auth0 user account once it detects the same email in the system. As a result, you will be able to log in using your Auth0 user account going forward.

To set up Auth0, please follow the guide below:

1. Turn on the production environment

2. Create an API key

3. Create Auth0 Application

4. Transfer Auth0 information to Circle

5. Set Login URI and Callback URL in Auth0

6. Create a social connection

7. Go live with SSO in Circle

8. Test Auth0 setup

If you haven’t already, change your tenant environment in Auth0 to Production unless you are just testing.

To change the environment:

1. Navigate to your Auth0 account.

2. Click the down arrow beside your tenant in the top-left corner → Settings.

   

3. Select Production under the Environment Tag section.

   

1. Click the Applications menu in the left sidebar → APIs.

2. Click Create API.

   

3. Give it a name for easy identification.

4. Add a logical Identifier: It can be your community link or Callback URL (See 5. Set Login URI and Callback URL for info on where to get Callback URL).

   

5. Click Create.

If you haven’t already, create an application for this setup in your Auth0 account:

1. Click the Applications menu in the left sidebar → Applications.

2. Click Create Application in the top-right corner.

   

3. Choose your preferred application type.

4. Click Create.

Please ensure that you have enabled appropriate grant types in your application to avoid an Auth0 error on the login page.

To manage grant types:

1. Click the Applications menu in the left sidebar → Applications.

2. Click the More actions (three dots) icon beside the application → Settings.

3. Scroll down to the Advance Settings option.

4. Select the Grant Types tab.

5. Select all the relevant grant types.

6. Click Save Changes.

Enable API

To ensure your API keys are active within your application:

1. Click the More actions (three dots) icon beside the application → APIs.

2. Toggle the API relevant to the application.

1. Click the Applications menu in the left sidebar → Applications.

2. Click the More actions (three dots) icon beside the application → Settings.

3. Under the Basic Information section, copy: 

   1. Domain

   2. Client ID

   3. Client Secret

1. Navigate to your community in a separate browser tab.

2. Click the community name or logo (or the dropdown icon next to it) in the top-left corner and select Settings.

3. Scroll down to the Community section and select Single sign-on.

4. Scroll down to the OAuth provider section.

5. Paste information.

6. Click Save changes.

❗Important: You must add https:// to the start of your Domain link copied from Auth0. The updated Auth0 Domain link can be pasted in your Circle SSO settings in the Auth0 URL field.

1. Navigate to Auth0.

2. Click the Branding menu in the left sidebar → Universal Login.

3. Scroll down and select Advance Options.

4. Click the Login tab.

5. Copy the Login URI from the Customize Login Page toggle.

1. Navigate to your community.

2. Click the community name or logo (or the dropdown icon next to it) in the top-left corner and select Settings.

3. Scroll down to the Community section and select Single sign-on.

4. Scroll down to the OAuth provider section.

5. Copy the Callback URL.

1. Click the Applications menu in the left sidebar → Applications.

2. Click the More actions (three dots) icon beside the application → Settings.

3. Scroll down to the Application URIs section.

4. Paste both links and save the changes.

ℹ️ Note: Make sure you add https:// before the Login URI to avoid error when saving changes.

❗Important: Before going live with the Auth0 setup, we suggest removing any social connections that are in development mode or that you no longer need.

To create social connection in Auth0:

1. Click the Authentication menu in the left sidebar → Social.

2. Click Create Connection in the top-right corner.

3. Choose from the given options, or scroll down and select Custom Connection.

ℹ️ Note: Based on the social connection option you choose, you may be required to complete additional setup on the social connection's developer account or console to activate the connection.

We will select Custom Connection as an example here:

1. Name: Add a name for this connection.

2. Authorization URL: Add a Callback URL from your community (copy it from Settings → SSO → OAuth provider section).

3. Token URL: Add Domain link from Auth0 (Applications → Settings → Basic Information) in this field along with /oauth/token at the end of the URL, e.g., https://YOUR_DOMAIN/oauth/token.

4. Scope: Add open profile email or openid profile email depending on your OAuth/Auth0 configuration.

5. Client ID: Add Client ID from your Auth0 account (Applications → Settings → Basic Information). 

6. Client Secret: Add Client Secret from your Auth0 account (Applications → Settings → Basic Information).

❗Important: Once you have created the social connection, make sure to enable it under Applications tab by turning on the toggle 👇.

Navigate to SSO settings in your community:

1. Click the community name or logo (or the dropdown icon next to it) in the top-left corner and select Settings.

2. Scroll down to the Community section and select Single sign-on.

Toggle the Enable SSO option to go live.

You can keep this enabled to allow your members with a Circle account to sign in. If enabled, you will see both Auth0 and Circle login options on your login page and can use the Circle option if your initial SSO setup does not work.

❗Important: In case you would like to turn off the Circle Sign in completely, please make sure to add your community account email as a user in Auth0.

Upon login, Circle will automatically sync your admin email account with Auth0 user account once it detects the same email in the system. As a result, you will be able to login using your Auth0 user account going forward.

You can enable this option if you would like to keep the sign up option visible in your community and redirect users to a custom sign up URL.

❗Important: Custom sign up option will only be visible if one of these options is enabled:1. You have set your community to public.2. You have enabled Allow members with a Circle account to sign in.

💡 Tip: Members will also have the option to sign up via the Auth0 application on the login page.

You can enable this option if you would like to skip the profile creation step for your members with preset name when they sign in to the community via SSO for the first time.

Enabling the state parameter enhances security by storing information in the session, adding it to the authorization URL, and verifying that the OAuth provider sends back the correct state parameter in the callback.

Once you have set your preferences and enabled SSO in your community, test the Auth0 setup by creating a test user.

1. Navigate to your Auth0 account.

2. Click the User Management menu in the left sidebar → Users.

3. Click Create User.

4. Auth0 sends a verification email for this user to activate the account. Verify your user email by navigating to your email account.

If your setup is successful, you will be presented with the Auth0 option (continue with Your application name) on the login page when signing in to your community:

1. Open your community URL in an Incognito/Private browsing session.

2. Sign in with test user credentials.

If you would like, make changes to your login page in your Auth0 account as per your preference by navigating to Branding → Universal Login.

💡 Tip: To learn more about the customization options, check out the Auth0 guide on Universal Login Pages here.

Once you have enabled SSO for your community, you can also verify the SSO connection at any time using our verification feature! To do this, click Verify SSO connection on the header of the SSO settings page and log in through your SSO provider. 

The tool will then verify your connection and provide logs for each verification step.

📚 For more information, see Verify your SSO connection.

You are now all set 🎉

• Auto-login members from SSO to your community

• Embed Circle on my website

• Access Circle API documentation

• Onboarding members to your SSO-enabled community

• Automate SSO member onboarding using Zapier

• Disabling SSO