Skip to main content

band quickstart

One-command setup: create app, VCP, and order a phone number

Synopsis

Quickstart creates everything you need to make voice calls.

By default, it uses the Universal Platform path (VCP). If your account is on the legacy platform, use --legacy for the sub-account/location path.

Re-running quickstart is safe on the default (VCP) path: existing resources are reused and a second number is never ordered. NOTE: re-running --legacy may order an additional paid number because legacy number ordering is not idempotent; prefer the default VCP path, which is.

band quickstart [flags]

Examples

# Universal Platform (default)
band quickstart --callback-url https://example.com/voice

# Legacy platform
band quickstart --callback-url https://example.com/voice --legacy

# Custom area code and name
band quickstart --callback-url https://example.com/voice --area-code 704 --name "Demo"

Options

--area-code string Area code to search for a number (default "919")
--callback-url string URL for voice callbacks (required)
-h, --help help for quickstart
--legacy Use legacy sub-account/location provisioning
--name string Name prefix for created resources (default "Quickstart")

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 - Bandwidth CLI — manage voice, messaging, numbers, and more from the command line