Docs Menu

Docs HomeLaunch & Manage MongoDBMongoDB CLI

mongocli iam projects create

On this page

  • Syntax
  • Arguments
  • Options
  • Inherited Options
  • Output
  • Examples

Create a project in your organization.

Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, and alert settings.

To use this command, you must authenticate with a user account or an API key with the Project Data Access Read/Write role.

Command Syntax
mongocli iam projects create <projectName> [options]
Name
Type
Required
Description
projectName
string
true
Label that identifies the project.
Name
Type
Required
Description
-h, --help
false
help for create
--orgId
string
false
Organization ID to use. This option overrides the settings in the configuration file or environment variable.
-o, --output
string
false
Output format. Valid values are json, json-path, go-template, or go-template-file. To see the full output, use the -o json option.
--ownerId
string
false
Unique 24-digit string that identifies the Atlas user to be granted the Project Owner role on the specified project. If unspecified, this value defaults to the user ID of the oldest Organization Owner.
--withoutDefaultAlertSettings
false
Flag that creates the new project without the default alert settings enabled. This flag defaults to false. This option is useful if you create projects programmatically and want to create your own alerts instead of using the default alert settings.
Name
Type
Required
Description
-P, --profile
string
false
Name of the profile to use from your configuration file. To learn about profiles for MongoCLI, see https://dochub.mongodb.org/core/atlas-cli-configuration-file.

If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.

Project '<ID>' created.
# Create a project in the organization with the ID 5e2211c17a3e5a48f5497de3 using default alert settings:
mongocli projects create --orgId 5e2211c17a3e5a48f5497de3 --output json
←  mongocli iam projects apiKeys listmongocli iam projects delete →