Circle supports Single Sign-On (SSO), and you can now integrate Circle with Auth0, making it a seamless experience for your Auth0 members to log in to your community! These 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 log in page.

🚨 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.

✅ Step 1: Set up Circle integration in Auth0


In Auth0, Navigate to API → Create API.


Locate your URL by navigating back to Circle. Circle Community Settings → Single Sign-On.

🚨 We recommend keeping the "Allow members with a Circle account to sign in" toggle enabled to avoid getting locked out of your account while setting up your SSO integration. In the case this happens, you can easily sign in again with your Circle credentials.
Once you paste in your callback URL, click "Create".

✅ Step 2: Copy over Auth0 SSO information to Circle


Navigate to back to Circle Settings → Single Sign-On, and select "Custom" as the OAuth provider.

Provide the name of your OAuth provider
Use the dropdown to select your OAuth provider. The name field is what will display under the login button. For example, if you input the name "Auth0", the login button will say "Continue with Auth0."

Insert your custom OAuth provider details
The Client ID, Secret Key, Authorization URL, Token Fetch URL, and User Info API URL should be provided to you by Auth0.

🚨 At the end of the Authorization URL paste the following string of text: ?scope=openid+email
Set up the response paths
This is the API URL for Circle to fetch user profile information such as email, name, and profile picture after authentication. Your OAuth provider should be able to provide these.

Response paths refer to nested information in your JSON API response. For example, if a user's email is returned by your API inside a "user" object, the response path should be user/email. In JSON, this will look something like:

{
  user: {
    email: "a-user@email.com",
    ...
  }
}



Click "Save changes" once the fields are completed.

✅ Step 3: Enable SSO
Once you've saved your settings, toggle "Enable SSO" to ON within Circle.
  • Allow members with a Circle account to sign in: If you have members that have already registered their email with Circle, they can still sign in with those credentials using a separate sign in button.


💡 What happens to Circle member accounts?
If this is toggled ON, Circle members can continue to login using the "Sign in with Circle" button. We will create accounts for Auth0 members automatically on our backend if the email doesn't exist within Circle.

If this is toggled OFF, members with Circle accounts will no longer be able to sign in with those credentials unless the email of their Circle account matches the email of their Auth0 account, in which case we'll link the two automatically going forward.

💡 What happens to my admin account?
If the email you use to log in to Auth0 is different from Circle, we recommend toggling this ON to ensure you don't get locked out of your admin account. Once you grant admin rights to both accounts you can always toggle this off later.

If this is toggled OFF, you will only be able to log in under your email that is registered within Auth0.
  • Allow members to sign up via a custom URL: After enabling SSO, members won't be able to sign up via Circle. However, you can keep the sign up button visible and point it to a custom URL.

🏁 If the setup was successful, you will now see the Login via Auth0 Single Sign-On option when trying to sign in under your community!

Suggested Articles: