Docs Menu

atlas organizations create

Create an organization.

When authenticating using API keys, the organization to which the API keys belong must have cross-organization billing enabled. The resulting org will be linked to the paying org.

Command Syntax
atlas organizations create <name> [options]
Name
Type
Required
Description

name

string

true

Label that identifies the organization.

Name
Type
Required
Description

--apiKeyDescription

string

false

Description of the API key. Required when creating organizations authenticated with API Keys.

--apiKeyRole

strings

false

Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles. Required when creating organizations authenticated with API Keys.

--federationSettingsId

string

false

Unique 24-hexadecimal digit string that identifies the federation settings.

-h, --help

false

help for create

-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 Org Owner role on the specified organization. Required if using API keys.

Name
Type
Required
Description

-P, --profile

string

false

Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

# Create an Atlas organization with the name myOrg:
atlas organizations create myOrg --output json