Circle.so Integration

To use MembershipWorks with Circle.so you will need to be on a Circle plan that offers Custom Single Sign-On. Please contact Circle for information on what is required to enable Custom Single Sign-On for your Circle plan.

To obtain the keys required you must be signed in as the primary admin to MembershipWorks.

  1. From Circle.so go to Community Settings > Single Sign-On
  2. Enable "Allow members to sign up via a custom URL" and "Allow members to sign up via a custom URL"
  3. Take note of the Callback URL just under OAuth Provider
  4. In MembershipWorks go to Organization Settings > Apps
  5. Click on Add App
  6. Make sure the Type is set to "OAuth2 Single Sign On"
  7. Give a name to the app - eg. "Circle.so"
  8. Enter the Callback URL from the Circle.so in step 3
  9. Click Create
  10. Take note of the Client ID, Client Secret, Token Endpoint and User Info Endpoint
  11. In Circle.so enter the name of the OAuth Provider - the name field is what will display under the login button. For example, if you input the name "MembershipWorks", the login button will say "Continue with MembershipWorks."
  12. Enter the Client ID, Client Secret (Secret Key), Token Endpoint (Token Fetch URL), and User Info Endpoint (User Info API URL) from MembershipWorks noted down in step 10.
  13. Under the Authorization URL enter the URL of your website that has the MembershipWorks "Member Sign In and Manage Account" snippet/shortcode (ie. the page on your website where members login to manage their account).
  14. The response paths are:
    User ID -> account_id
    User Email -> email
    User Name -> name
  15. Click Save Changes
  16. Toggle "Enable SSO" to on