# Create a new app

**POST /groups/{groupId}/apps**




## Servers
- The root API resource and starting point for the App Services API.: https://services.cloud.mongodb.com/api/admin/v3.0 (The root API resource and starting point for the App Services API.)


## Authentication methods
- Token auth


## Parameters

### Path parameters
- **groupId** (string)
  An Atlas [Project/Group
  ID](https://docs.atlas.mongodb.com/tutorial/manage-projects/).

### Query parameters
- **defaults** (boolean)
  Whether or not to create a default application.
- **product** (string)
  The App's product type. Apps use the `standard` product type
  by default. For most apps, you do not need to specify a
  `product` at all, or should specify `standard`.

  The `atlas`, `data-api`, and `device-sync`
  product types represent special apps for
  [Atlas Triggers](https://docs.mongodb.com/atlas/triggers),
  [Atlas Data API](https://docs.mongodb.com/atlas/api/data-api/),
  and [Atlas Device Sync](https://www.mongodb.com/ko-kr/docs/atlas/app-services/sync/)
  that you can access through the Atlas UI.

### Body: application/json (object)
The application to create.
- **name** (string)
  The name of the application. Must begin with a letter and
  may only contain ASCII letters, numbers, underscores, and
  hyphens.
- **provider_region** (string)

- **location** (string)
  An identifier of the location where an app server is physically
  deployed to, regardless of the cloud provider that hosts the
  app.
- **deployment_model** (string)
  An application [deployment model](https://www.mongodb.com/ko-kr/docs/atlas/app-services/apps/deployment-models-and-regions/#deployment-models).
- **environment** (string)
  The application's environment.
- **template_id** (string)
  The id of an [App Services template
  app](https://www.mongodb.com/ko-kr/docs/atlas/app-services/reference/template-apps)
  to use as a base for the new app.
- **data_source** (object)



## Responses
### 201
The application was successfully created.

#### Body: application/json (object)
- **name** (string)
  The name of the application. Must begin with a letter and
  may only contain ASCII letters, numbers, underscores, and
  hyphens.
- **provider_region** (string)

- **location** (string)
  An identifier of the location where an app server is physically
  deployed to, regardless of the cloud provider that hosts the
  app.
- **deployment_model** (string)
  An application [deployment model](https://www.mongodb.com/ko-kr/docs/atlas/app-services/apps/deployment-models-and-regions/#deployment-models).
- **environment** (string)
  The application's environment.
- **_id** (string)
  The application's unique internal ID.
- **client_app_id** (string)
  The application's public App ID.
- **domain_id** (string)
  The application's associated domain ID.
- **group_id** (string)
  The application's [Atlas Project/Group ID](https://docs.atlas.mongodb.com/tutorial/manage-projects/).
- **last_used** (integer)
  The time this app was last used in [UNIX time](https://en.wikipedia.org/wiki/Unix_time) (i.e. the number of seconds since Jan 1, 1970).
- **last_modified** (integer)
  The time this app was last modified in [UNIX time](https://en.wikipedia.org/wiki/Unix_time) (i.e. the number of seconds since Jan 1, 1970).
- **product** (string)
  The product this app is for.

### 400
There is an error in the request.

#### Body: application/json (object)
- **error** (string)
  A message that describes the error.
- **error_code** (string)
  The error type.


[Powered by Bump.sh](https://bump.sh)