Skip to main content

band number activate

Activate voice or messaging services on phone numbers

Synopsis

Creates a service activation order to enable voice and/or messaging services on one or more phone numbers via the Universal Platform.

At least one service flag must be provided. Use --dry-run to check eligibility (status per service) without creating an order. Use --wait to block until the order reaches a terminal status.

Underlying API: POST /api/v2/accounts/{accountId}/serviceActivation

band number activate <number...> [flags]

Examples

# Enable inbound voice on a single number
band number activate +19195551234 --voice-inbound

# Enable all voice services on multiple numbers and wait
band number activate +19195551234 +19195551235 --voice-inbound \
--voice-outbound-national --voice-outbound-international --wait

# Eligibility check only — no order created
band number activate +19195551234 --voice-inbound --dry-run

# With a customer-supplied order ID for tracking
band number activate +19195551234 --voice-inbound --customer-order-id my-order-123

Options

--customer-order-id string Optional customer-supplied order ID for tracking
--dry-run Run the eligibility checker instead of creating an order
-h, --help help for activate
--messaging Target the messaging (ALL) service
--timeout duration Maximum time to wait when --wait is set (default 60s) (default 1m0s)
--voice-inbound Target the voice INBOUND service
--voice-outbound-international Target the voice OUTBOUND_INTERNATIONAL service
--voice-outbound-national Target the voice OUTBOUND_NATIONAL service
--wait Block until the order reaches a terminal status

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