# Create a new Secret

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

Create a new
[Secret](https://www.mongodb.com/zh-cn/docs/atlas/app-services/values-and-secrets/define-and-manage-secrets).


## 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/).
- **appId** (string)
  The ObjectID of your application.
  [The App Services API Project and Application IDs section](#section/Project-and-Application-IDs) demonstrates how to find this
  value.


### Body: application/json (object)
The Secret to create.
- **name** (string)

- **value** (string)



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

#### Body: application/json (object)
- **_id** (string)

- **name** (string)



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