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
- band subaccount - Manage sub-accounts