ANNOUNCEMENT: Voyage AI joins MongoDB to power more accurate and trustworthy AI applications on Atlas.
Learn more
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