Skip to main content

band subaccount create

Create a new sub-account

Synopsis

Creates a new sub-account under the active account. Use --if-not-exists to make the command idempotent, returning the existing sub-account instead of erroring when one with the same name already exists.

band subaccount create [flags]

Examples

band subaccount create --name "Production"
band subaccount create --name "Production" --description "Prod traffic"

# Idempotent — safe to re-run
band subaccount create --name "Production" --if-not-exists

Options

--description string Sub-account description
-h, --help help for create
--if-not-exists Return existing sub-account if one with the same name already exists
--name string Sub-account name (required)

Options inherited from parent commands

--account-id string Bandwidth account ID (overrides config)
--environment string API environment: prod, test (overrides config)
--format string Output format: json or table (default "json")
--plain Simplified flat JSON output (recommended for scripts and agents)

SEE ALSO