JumpCloud unifies clients' technology stack across identity, access, and device management. Deel's JumpCloud integration uses a robust SCIM API infrastructure to sync EOR employees, direct employees, and independent contractors. This keeps user management accurate and up-to-date across both platforms.
With this integration, Deel HR clients can:
-
Add users to JumpCloud when added in Deel
-
Deprovision (suspend) users when offboarded in Deel
-
Sync worker details when updated in Deel
This article explains how clients can set up the JumpCloud integration on Deel for SSO.
In this article
- Before you begin
- Step 1. Prepare JumpCloud
- Step 2. Connect the integration
- Step 3. Configure the integration
- Step 4. Sync data manually
- JumpCloud integration reference
- Frequently asked questions (FAQs)
Before you begin
To successfully set up the JumpCloud integration, you’ll need:
- A user with an admin role on Deel
- A user with an admin role on JumpCloud
Step 1. Prepare JumpCloud
You'll need an API Key from JumpCloud to connect the integration.
To generate an API key from JumpCloud:
1. Click the profile avatar in JumpCloud and select My API Key.
2. From the API Key modal, select an expiration date and click Generate New API Key.
3. Copy the generated API key.
Now that you have an API Key, you can go back to Deel to connect the integration.
Step 2. Connect the integration
1. Go to More > Apps > JumpCloud.
2. Click Connect on JumpCloud.
3. On the JumpCloud modal, enter your API Key and click Connect & go to settings.
The integration is now connected, you can start to configure the integration.
Step 3. Configure the integration
In this section, we’ll guide you through configuring the integration so that data can sync successfully.
After connecting JumpCloud, configuring it consists of:
Configure the field mapping plugin
This plugin allows users to easily select and sync specific fields between Deel and JumpCloud.
To configure the field mapping plugin:
1. From the JumpCloud integration page, go to the Plugins and settings tab.
2. Click Field Mapping.
3. Customize the user field mapping for JumpCloud.
The Field Mapping plugin is configured. Changes in employee data will be synced from Deel to JumpCloud.
Configure the user provisioning plugin
This plugin automatically creates JumpCloud accounts for new hires and suspends accounts upon termination.
To configure the user provisioning plugin:
1. From the JumpCloud integration page, go to the Plugins and settings tab.
2. Next to the User provisioning plugin, click Enable.
3. Choose the events you want to sync.
The User Provisioning Plugin is configured, new hires will be automatically provisioned in JumpCloud, and terminated accounts will be suspended.
Any HR fields that change on Deel will be synced. For instance, changes to a job title will be updated in JumpCloud after the next sync.
Step 4. Sync data manually (For Deel HR clients only)
Automatic syncs occur daily, one way from Deel to JumpCloud, but you can manually trigger a sync:
- If you’ve made important changes and need them to sync immediately
- If you notice missing data or errors that suggest that the last sync didn’t complete correctly
To sync data, go to the JumpCloud integration page and click Sync JumpCloud.
Recent changes in employee data will be synced from Deel to JumpCloud.
JumpCloud integration reference
This section provides information about the capabilities and limitations of the integration. You can use it to understand whether the integration can sync the data you need to sync.
Supported contract types
The JumpCloud integration supports the following contract types:
- Independent contractor
- Employer of record (EOR)
- Global payroll
- Professional employer organization (PEO)
Supported sync fields
The JumpCloud integration supports the sync of the following fields:
Mapped from Deel | Description | Mapped by default? |
---|---|---|
Frequently asked questions (FAQs)
[ACCORDION] If a worker's details are changed, how often will the changes sync in JumpCloud?
Any profile changes, new user additions, or terminations will automatically sync to JumpCloud through the integration.
[ACCORDION] Why are some workers not syncing?
Please ensure that both the worker's personal email and work email (used for company email) during the profile creation have been entered correctly, or the integration will not work properly.
[ACCORDION] How often will the integration sync?
The integration will sync every hour, 20 minutes past the hour.
[ACCORDION] If a worker is terminated what happens to their JumpCloud profile?
A user state in JumpCloud can be changed from Staged to Active, Active to Suspended, and Suspended to Active.
Staged users can’t receive emails.
A user state can't be changed back to Staged once activated.
When a worker is terminated in Deel, their user state in JumpCloud will move to Suspended during the following sync.
[ACCORDION] What does this integration use for setting up SSO?
Currently, this only includes SCIM provisioning and de-provisioning.
However, any client can use our generic SAML 2.0 connector base for setting up SSO, including with Jumpcloud.
[/ACCORDION]