The JumpCloud integration centralizes identity and access management, eliminating the manual work of provisioning users across disconnected systems.
You can automate user onboarding and offboarding, manage group memberships, and sync identity data directly from Atomicwork. This reduces provisioning delays, cuts down on access-related requests, and ensures employees get the right access at the right time without manual intervention.
Usecases
Connecting JumpCloud to Atomicwork unlocks several key capabilities for your IT and HR teams:
Identity governance: Automate user provisioning and deprovisioning as part of your workflows.
Group management: Add or remove users from user groups automatically during role changes.
Account recovery: Unlock locked user accounts via self-service.
Permissions
To connect your Atomicwork and JumpCloud accounts, you need:
Org admin access in Atomicwork
A JumpCloud API key with read and write access to the following areas:
System Users
User Groups
Directory Insights
Permission | Purpose |
View users | To sync user profiles and ensure workflows have access to the necessary user data. |
Create users | To create new users automatically as part of workflows and journey actions. |
Delete users | To remove users through workflows and journey actions. |
Suspend users | To temporarily suspend user accounts through workflows and journey actions. |
Deactivate users | To deactivate users through workflow and journey actions. |
Activate users | To reactivate users who need to regain access to your JumpCloud applications. |
Edit users' profile attributes | To update user attributes, ensuring the latest data is synced to Atomicwork and used in workflows. |
Reset passwords | To support resetting passwords as part of skills. |
MFA resets | To allow resetting multi-factor authentication as part of workflows. |
Manage API tokens | To create an API token that will be shared with Atomicwork for setting up the integration. |
View API tokens | To view and access the API token shared with Atomicwork. |
View groups | To retrieve the list of groups and associated information for workflow actions and skills. |
Manage group membership | To add or remove users from groups through workflows and journey actions. |
Create groups | To create groups through workflows and journey actions. |
Manage applications | To view application details and client credentials, and to assign users to applications based on their group membership or direct assignment. |
View roles | To ensure workflows have visibility into user roles for proper access control and auditing. |
View admin assignments | To verify administrators who are responsible for specific roles, ensuring proper workflow execution. |
Setup
Your JumpCloud API key is required to authorize the integration. This key is sent securely in every request to authenticate your workspace.
Generate a new JumpCloud API key:
Log in to the JumpCloud Admin Portal and click on your account initials in the bottom-left or top-right
Click on My API Key > Generate New API Key
Copy and securely store the API key
In your Atomicwork account, navigate to Settings > App store > JumpCloud.
Enter your API key and click on Test to test the connection.
Click on Connect to activate the integration
Supported workflow actions
Once connected, you can automate the following JumpCloud actions within your Atomicwork workflows:
Action | Description |
Get system user | Retrieve a specific system user by their ID. |
List users | List all system users. |
Create user | Create a new system user in JumpCloud. |
Update user | Update an existing system user's profile. |
Delete user | Delete a system user account. |
Unlock user | Unlock a locked user account. |
Suspend user | Temporarily suspend a user account. |
Deactivate user | Deactivate a user account entirely. |
Add user to group | Assign a user to a specific user group. |
Remove user from group | Remove a user from a specific user group. |
Get last logged event | Query user events from Directory Insights. |
Call API | Make a generic API call to any JumpCloud endpoint |
Troubleshoot common issues
If you encounter issues while setting up or using the JumpCloud integration, review the following common errors:
Error message | Cause | Resolution |
api_key is null | The integration configuration is missing the API key. | Re-enter your API key in the integration settings. |
401 or 403 errors | Your API key lacks the required permissions or has been revoked. | Generate a new key with the correct permissions in the JumpCloud Admin Console. |
JumpCloud client error | The API call to JumpCloud encountered an error response. | Check the JumpCloud API status page to ensure their services are operational. |