This guide contains the following sections:
Create Users. New users created in Okta will be automatically synced and created in Fellow
Update User Attributes. Changes in Okta users profiles, assigned to an application, will be synced to Fellow
Deactivate Users. Deactivation of users in Okta will result in unable them to log in plus marking as "Inactive" in Fellow
Reactivate Users. Users, reactivated in Okta, will be able to log in into Fellow again and be marked as "Active"
Group Push. Groups created in Okta can be pushed into Fellow as Teams
You need to have a Fellow account with an Enterprise plan to use this feature, and it must be enabled by a team including a Fellow admin and an OKTA admin (or your IT team)
Step-by-Step Configuration Instructions
Enable the integration in Fellow
From a workspace administrator account, navigate to the Account Integrations section in Workspace Settings, and then to the SCIM2 card.
Click the Connect button on the top right corner of the page
You will then see this form:
Then press Regenerate SCIM token, confirm an action:
After, copy your SCIM token, save it temporarily in a safe place, it is required for the next step
Configuring SCIM params in Okta
Log in to your Okta account, and navigate to Applications (URL: https://<your_workspace>.okta.com/admin/apps/active)
If you have already set up OIDC, navigate to the application and select the “Provisioning” tab. If not, click Browse App Catalog, search for "Fellow.app", and click the Add button.
You will reach the integration configuration form Add Fellow.app, where you need to specify your Fellow subdomain
Click the Provisioning tab, check the Enable API integration checkbox, and paste the API key from Fellow into the form:
After a successful test (using the Test API Credentials button), press Save
Select To App tab, click Edit
Check all 3 checkboxes (Create users, Update User Attributes, Deactivate Users) then press Save
The last step - navigate into Sign On tab, press "Edit" settings
Select Email for the Application username format field. Then press Save
Now you’re all set! You can assign users to an app, and manage them with Okta.
Troubleshooting and Tips
Please note, that we don’t support username/email updates. If you going to switch from one domain to another, or move / merge users, please contact support.
The support team could be contacted through Intercom or email (firstname.lastname@example.org) and always happy to help you.