Skip to main content
You must have Organization Owner access to the MongoDB Atlas organization to create a service account.

​
Create a service account

Create an organization-level service account in MongoDB Atlas to obtain OAuth 2.0 client credentials for the Atlas Administration API.

1

Sign in to MongoDB Atlas

Sign in to your MongoDB Atlas account.

  • Select your organization using the Organization selector at the top left.
  • In the left sidebar, expand Identity & Access and click Applications.
2

Open the Service Accounts tab

On the Applications page, select the Service Accounts tab.

  • Click Create service account.
The Applications page in MongoDB Atlas with the Service Accounts tab selected and the Create service account button highlighted.
3

Enter service account information

On the Create Service Account screen, under Enter Service Account Information, complete the form.

  • Name: enter a name such as StackOne Integration (must not be more than 64 characters).
  • Description: enter a description of the service account — this field is required (must not be more than 250 characters).
  • Choose a Client Secret Expiration period (the default is 90 days (recommended)). You can’t change this once the secret is created.
  • From Organization Permissions, select the roles this integration needs — for example Organization Owner for full access, or Organization Read Only for read-only access.
  • Click Create.
The Create Service Account form in MongoDB Atlas showing the Name, Description, Client Secret Expiration, and Organization Permissions fields.

​
Copy your credentials

After the service account is created, MongoDB Atlas displays its credentials.

1

Copy the Client ID and Client Secret

On the Service Account Information screen, copy both values and enter them in StackOne Hub.

  • Click Copy next to Client ID and enter it as the Service Account Client ID in StackOne Hub.
  • Click Copy next to Client Secret and enter it as the Service Account Client Secret in StackOne Hub.
  • The Client Secret is only displayed once and cannot be retrieved later — after you leave this page the full client secret is unavailable, so store it securely.
The Service Account Information screen in MongoDB Atlas showing the Client ID and Client Secret with Copy buttons (values redacted).

​
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:
  • Service Account Client ID
  • Service Account Client Secret
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.