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. If you already have service accounts, click Add new in the top-right corner, then select 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 any descriptive name, e.g. 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 Organization Owner. This is the minimum role required for the integration to work: it is the only organization role that can manage teams and organization API keys while also granting write access to projects, clusters, database users, and IP access lists across all projects.
  • If you only need read access, Organization Read Only is sufficient, but write operations (creating or updating resources) will not work.
  • 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 copy it across to Service Account Client ID.
  • Click Copy next to Client Secret and copy it across to Service Account Client Secret.
  • The Client Secret is only displayed once and cannot be retrieved later — after you leave this page the full client secret is unavailable, so copy and store it securely before leaving.
The Service Account Information screen in MongoDB Atlas showing the Client ID and Client Secret with Copy buttons (values redacted).
1

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.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

​
Next Steps

Webhooks setup

Configure receiving Events for MongoDB Atlas into StackOne.