Create an App with App Services API

Authenticate a MongoDB Atlas User

Use your MongoDB Cloud API key pair to call the authentication endpoint:

curl --request POST \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"username": "<Public API Key>", "apiKey": "<Private API Key>"}' \
  https://realm.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login

If authentication succeeds, Atlas App Services returns an access token as part of the JSON response document:

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

Save the access_token, which you'll use as the Bearer token to authenticate in the upcoming steps.

Get the Group ID

To create a App you need the Project ID (sometimes referred to as the Group ID) of the MongoDB Atlas project that contains the app. You will include this ID in the URL of API requests.

Create a new App

You can create a new App through the create endpoint.

Your request should include:

• The access_token from step 1 in a Bearer token Authorization header.
• The Group ID from step 2.
• A name for your new app.

If creation succeeds, the Atlas App Services returns a 201 response and a JSON document.