Docs Menu

Realm CLI Authenticate With API Token

On this page

  • Overview
  • Generate an API Key
  • Navigate to MongoDB Cloud Access Manager
  • Configure Your API Whitelist
  • Authenticate with an API Key
  • Authenticate a CLI User

MongoDB provides the Realm Command Line Interface (realm-cli) to manage your Realm apps programmatically. You can authenticate a MongoDB Cloud User with an API key for your project. Generate an API key through the access manager in your MongoDB Cloud account.


The MongoDB Cloud Access Manager allows you to manage access to your project for users, teams, and API Keys. Use the Project Access Manager by clicking the Project Access tab on the access manager dropdown on your screen's top left-hand side.

Click Access Manager
click to enlarge

Copy your Private Key to a safe location for later use. For security, the Private Key will not be visible again after initialization. Another security feature is API Whitelisting. Creating an API Whitelist ensures that API calls originate from whitelisted IPs.

The IP Address of the user who will be using the API Key is required to use the key. Click the Add Whitelist Entry button to whitelist an IP address. Type in the IP Address or click the Use Current IP Address buttton and click save. Finally, click the done button on your screen's lower right-hand to finish setting up your API key.

Click Access Manager
click to enlarge

Using your newly created public and private key, log in by running the command below.

realm-cli login --api-key="<my api key>" --private-api-key="<my private api key>"

You should see the following result:

you have successfully logged in as <your public key>
Give Feedback
© 2021 MongoDB, Inc.


  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.