These instructions assume you already set up SAML-based SSO in Okta for FreeBusy according to How to enable Single Sign on with Okta.

System for Cross-domain Identity Management (SCIM) automates provisioning, updating, and de-provisioning of user accounts across different applications. FreeBusy SCIM integration builds on this to automate licensing and de-licensing of user accounts:

when a user is assigned to the FreeBusy SCIM app in Okta, they are automatically added to your Enterprise subscription

when a user is disabled or deleted from the FreeBusy SCIM app in Okta, their license is automatically removed, freeing it up for other users

Note: using the FreeBusy SCIM Integration in Okta does not remove the need for users or tenant admin to authorize FreeBusy to access calendars. Okta SAML-based SSO is only used for authentication, not authorization. FreeBusy uses OAuth for authorization hence the separate need to OAuth consent.

Set up FreeBusy SCIM Integration on Okta:

Step 1: Go to the Applications on the left sidebar and click on ‘Applications‘

Step 2 : Search for the FreeBusy app that you created in How to enable Single Sign on with Okta and click on it to edit.

Step 3: On the General tab click Edit

Step 4: Select SCIM and click Save

Step 5: You will now see a Provisioning tab

Step 6: On Provisioning tab, click Edit button

Step 7: Enter the following values:

SCIM connector base URL: https://api.freebusy.io/scim
Unique identifier field for users: userName
Supported provisioning actions: Push New Users and Push Profile Updates
Authentication mode: HTTP Header

Step 8:

To obtain the Authorization Token, go to FreeBusy subscription management at https://freebusy.io/app/subscriptions and click on the ‘Enterprise Plan‘ button:

Step 9: Now go to the API Keys tab,

click on the ‘Copy to clipboard’ button and paste the token in the Authorization Token field on the Okta app page

Step 10:

Now click on Test Connector Configuration to verify and if successful click Save

Step 11:

Once saved, the screen would take you to the newly added ‘To App’ option under Settings on the left. Click the ‘Edit’ button to start provisioning

Step 12:

Select ‘Enable’ for Create Users, Update User Attributes and Deactivate Users, and click Save. (Ignore the Sync Passwords Option)

Step 13:

Scroll to the bottom to find Attribute Mappings. Under Attribute Mappings, remove all attributes except Email, Username, Given name, and Family name

Step 14

That’s it! Now, if can go to the ‘Assignments’ tab and assign the people in your organization who should be added to the FreeBusy subscription