Skip to main content
Only Admins with Billing role can create Service Accounts. Each Admin with Billing can create up to 40 Service Accounts.

​
Creating a Service Account

Service Accounts provide OAuth 2.0 authentication for automated integrations without user intervention.

1

Sign in to JumpCloud Admin Portal

Sign in to your JumpCloud Admin Portal.

2

Navigate to Service Accounts

In the Admin Portal, go to Settings > Service Accounts.

3

Create a New Service Account

Click + New to add a new Service Account.

  • Enter a Name for the Service Account
  • Select a Role from the dropdown menu (e.g., Administrator, Manager)
  • Under Key Type, select Client Secret
4

Configure and Activate

Click the Configure button. A Configure Client Secret popup will be displayed.

  • Select the duration of expiration from the Secret Lifetime dropdown menu
  • Click Activate to create the Service Account
5

Copy Client Credentials

Copy the Client ID and Client Secret and store them securely for use later.

  • Credentials are only displayed at the time they’re created
  • Each Service Account has 2 Client Secrets for rotation
  • You will be emailed 7 days before expiration

​
Selecting Your API Region

JumpCloud operates in two regions. Select the region that matches your JumpCloud organization.

1

Identify Your Region

Check the URL you use to access JumpCloud Admin Portal.

  • US Region: If you use console.jumpcloud.com
  • EU Region: If you use console.eu.jumpcloud.com

​
Finding Your Organization ID (Optional)

The Organization ID is only required if you manage multiple organizations through JumpCloud’s Multi-Tenant Portal (MTP).

1

When Organization ID is Needed

Organization ID is required for Managed Service Providers (MSPs) using the Multi-Tenant Portal.

  • If you only manage one organization, leave this field empty
  • MSP Admins need the Organization ID to query specific client organizations
2

Locate Your Organization ID

To find your Organization ID, navigate to your organization settings in the Admin Portal.

  • Go to Settings in the Admin Portal
  • Your Organization ID is displayed in the Organization Profile tab
  • Format example: 5a1234567890abcdef123456

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Client ID
  • Client Secret
  • API Region
  • Organization ID (Optional)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.