# How to Use the MongoDB Atlas Administration API in Postman

![](https://blog.postman.com/wp-content/uploads/2021/11/lauren-schaefer-postman-blog-mongodb-150x150.jpg)

*This is a guest post written by Lauren Schaefer, staff developer advocate at MongoDB.*

 [MongoDB Atlas](https://cloud.mongodb.com/) is a multi-cloud document database service that makes working with data easy. Atlas has a web interface that allows you to configure your databases, charts, data lakes, and application services with a few clicks of the mouse. Atlas also has an [Administration API](https://docs.atlas.mongodb.com/api/), which you can use to programmatically interact with the database service. For example, you can use the Atlas Administration API to create database deployments, add users to those deployments, monitor those deployments, and more. These API calls are especially useful to those who create CI/CD pipelines as well as to IT professionals who create self-serve developer portals. Postman is a popular [API platform](https://www.postman.com/api-platform/) that makes working with APIs easy. MongoDB Senior Solutions Architect [Cassiano Ziegler Bein](https://www.linkedin.com/in/cassianobein/) created a [Postman Collection](https://www.postman.com/collection/) that contains a request for every endpoint in the Atlas Administration API. This collection is an excellent complement to the detailed MongoDB documentation on the Atlas Administration API. In this blog post, I'll walk you through how to access and use Cassiano's Postman Collection, so you can quickly learn to use the Atlas Administration API. ## Set up Atlas

 The first thing you'll need to do is create a database deployment in Atlas. Note that a free database deployment is sufficient for this tutorial. If you want to run all of the APIs in the collection, you will need to upgrade to a paid deployment. 1. Navigate to [Atlas](https://www.mongodb.com/cloud/atlas/register) and then [register](https://docs.atlas.mongodb.com/tutorial/create-atlas-account/) or authenticate.
2. [Create an Atlas organization](https://docs.atlas.mongodb.com/tutorial/manage-organizations/#std-label-create-organization). This organization is where you will store your projects.
3. [Create a project](https://docs.atlas.mongodb.com/tutorial/manage-projects/#std-label-create-project) in the organization you just created. The project is where you will store your database deployments.
4. [Create a database deployment](https://docs.atlas.mongodb.com/create-database-deployment/#create-a-new-database-deployment) in the project you just created. The database deployment is where your databases will be stored.
5. [Navigate to the Project Settings page for your project](https://docs.atlas.mongodb.com/tutorial/manage-project-settings/). Store the **Project ID** in a safe place. You will use it later in Postman.
 
 ![ Screenshot of the Atlas web interface's Database Deployments page](https://blog.postman.com/wp-content/uploads/2021/11/mongodb-postman-blog-1.png)Atlas displays the database deployments Now that you have a database deployment, let's create an [API key](https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key). You will use this API key later in Postman to authenticate to Atlas. 1. [Create an API key](https://docs.atlas.mongodb.com/tutorial/configure-api-access/organization/create-one-api-key/) in the organization you created in the previous section. Grant the API key the **Organization Owner** permission.
2. [Add your current IP address to the API Access List for this API key](https://docs.atlas.mongodb.com/tutorial/configure-api-access/organization/create-one-api-key/#add-an-api-access-list-entry).
3. Store the API public key and private key in a safe place. You will use them later in Postman.
 
## Set up Postman

 In this section, you'll complete two tasks: fork a copy of the Postman Collection with all of the Atlas Administration API calls and configure the authorization for all of the requests in the collection. **Note**: The steps below will use the Postman web interface, but you can choose to use the Postman desktop application if you'd like. 1. Fork the [MongoDB Atlas collection](https://www.postman.com/mongodb-devrel/workspace/mongodb-public/overview) to one of your [Postman workspaces](https://www.postman.com/product/workspaces/) using this button:[![](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/17637161-25049d75-bcbc-467b-aba0-82a5c440ee02?action=collection%2Ffork&collection-url=entityId%3D17637161-25049d75-bcbc-467b-aba0-82a5c440ee02%26entityType%3Dcollection%26workspaceId%3D8355a86e-dec2-425c-9db0-cb5e0c3cec02#?env%5BAtlas%5D=W3sia2V5IjoiYmFzZV91cmwiLCJ2YWx1ZSI6Imh0dHBzOi8vY2xvdWQubW9uZ29kYi5jb20iLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6InZlcnNpb24iLCJ2YWx1ZSI6InYxLjAiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlByb2plY3RJRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJDTFVTVEVSLU5BTUUiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiZGF0YWJhc2VOYW1lIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6ImRiVXNlciIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJPUkctSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiQVBJLWtleS1wd2QiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiQVBJLWtleS11c3IiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiSU5WSVRBVElPTl9JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJJTlZPSUNFLUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlBST0pFQ1RfTkFNRSIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJURUFNLUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlVTRVItSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiUFJPSi1JTlZJVEFUSU8tSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiVEVBTS1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlNBTVBMRS1EQVRBU0VULUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkNMT1VELVBST1ZJREVSIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkNMVVNURVItVElFUiIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJJTlNUQU5DRS1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkFMRVJULUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkFMRVJULUNPTkZJRy1JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJEQVRBQkFTRS1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkNPTExFQ1RJT04tTkFNRSIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJJTkRFWC1JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJTTkFQU0hPVC1JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJKT0ItSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiUkVTVE9SRS1KT0ItSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoicmVzdG9yZUpvYklkIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlRBUkdFVC1DTFVTVEVSLU5BTUUiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiVEFSR0VULUdST1VQLUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6InRhcmdldEdyb3VwSWQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiY2x1c3Rlck5hbWUiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiUkVTVE9SRS1JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJBUkNISVZFLUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkNPTlRBSU5FUi1JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJQRUVSLUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkVORFBPSU5ULVNFUlZJQ0UtSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiRU5EUE9JTlQtSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiQVBJLUtFWS1JRCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJBQ0NFU1MtTElTVC1FTlRSWSIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJJUC1BRERSRVNTIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlBST0NFU1MtSE9TVCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJQUk9DRVNTLVBPUlQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiRElTSy1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkhPU1ROQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkxPRy1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlVTRVItTkFNRSIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJST0xFLUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkVWRU5ULUlEIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IkRBVEEtTEFLRS1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6IlZBTElEQVRJT04tSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiTElWRS1NSUdSQVRJT04tSUQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWV9LHsia2V5IjoiUk9MRS1OQU1FIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlfV0=) A copy of the MongoDB Atlas [collection](https://www.postman.com/collection/) and the Atlas [environment](https://learning.postman.com/docs/sending-requests/managing-environments/) will be added to your workspace. You will be redirected to your workspace.
2. Open the **MongoDB Atlas** collection and then the **Authorization** pane.
3. Ensure the **Type** is set to **Digest Auth**.
4. Input the Atlas API Public Key in the **Username** field.
5. Input the Atlas API Private Key in the **Password** field.
6. Save the collection.
 
 ![Screenshot of the MongoDB Atlas collection in the Postman web interface](https://blog.postman.com/wp-content/uploads/2021/11/mongodb-postman-blog-2.png)The MongoDB Atlas collection in Postman The requests in the collection are grouped together by the resource they interact with. Each resource has its own folder. For example, you'll find folders for Clusters, Projects, and Alerts. Some of the requests in the collection use variables. The variables allow you to configure the requests for your Atlas project. A [Postman environment](https://learning.postman.com/docs/sending-requests/managing-environments/) is a place to store variables the requests can use. When you forked the MongoDB Atlas collection, a copy of the Atlas environment was also added to your workspace. In this section, you'll update a variable stored in the Atlas environment. 1. [Open the Atlas environment for editing](https://learning.postman.com/docs/sending-requests/managing-environments/#editing-environment-variables).
2. [Update the current value of the **ProjectID** variable](https://learning.postman.com/docs/sending-requests/managing-environments/#editing-environment-variables) to the Atlas project ID you retrieved in an earlier section.
3. [Select the Atlas environment as your active environment](https://learning.postman.com/docs/sending-requests/managing-environments/#selecting-an-active-environment).
 
## Make a request

 Now that you have configured Atlas and Postman, you are ready to make your first request. 1. In the **MongoDB Atlas** collection, expand the **Clusters** folder.
2. Select the **Get All Clusters** request. See the [MongoDB documentation](https://docs.atlas.mongodb.com/reference/api/clusters-get-all/) for details on the Get All Clusters endpoint.
3. Click **Send** to run the request. The [API endpoint](https://blog.postman.com/what-is-an-api-endpoint/) returns information about the clusters in your project.
 
 **Note**: If you are running this request in the Postman web interface instead of the Postman desktop application, the API may return a 403 error indicating that an IP address is not allowed to access the resource. This is because the request is coming from the Postman server instead of your local machine. During development and testing, you may choose to [add the Postman server's IP address to your API key's access list](https://docs.atlas.mongodb.com/tutorial/configure-api-access/organization/create-one-api-key/#add-an-api-access-list-entry). ![Screenshot of the Get All Clusters request with a "Pretty" response in the Postman web interface](https://blog.postman.com/wp-content/uploads/2021/11/mongodb-api-postman-blog-3.png)The Get All Clusters request and its response You did it! You made your first request to the Atlas Administration API from Postman. The MongoDB Atlas collection contains requests for a variety of endpoints. Take some time to explore the requests in the collection and try them out. **Note**: GET requests retrieve information from Atlas. Other request types like POST, PATCH, and DELETE will make changes to your Atlas resources. ## Summary

 The MongoDB Atlas Administration API provides you with a programmatic way to manage your data and configurations in the Atlas cloud data platform. The MongoDB Atlas Postman Collection simplifies getting started and exploring the Atlas Administration API. Want to see the MongoDB Atlas Postman Collection in action? Join us for our upcoming livestream: - ["Learning with Luce - Automate the Automation on MongoDB Atlas (Atlas API & Postman)"](https://live.mongodb.com/events/details/mongodb-mongodb-global-virtual-community-presents-learning-with-luce-automate-the-automation-on-mongodb-atlas-atlas-api-postman/) on January 13, 2022: featuring [Luce Carter](https://www.linkedin.com/in/lucecarter/) (developer advocate at MongoDB), [Cassiano Ziegler Bein](https://www.linkedin.com/in/cassianobein/) (solutions architect at MongoDB), and [Meenakshi Dhanani](https://www.linkedin.com/in/meenakshi-dhanani/) (developer advocate at Postman).
 
 If you have any questions about the Atlas Administration API or how to use this collection, join us in the [MongoDB Community](https://community.mongodb.com/). MongoDB employees and members of our community are there every day answering questions. I hope to see you there! *Technical review by Arlemi Turpault.*