band portin create

Create a draft port-in order

Synopsis

Creates a port-in order in DRAFT state. With --loa, also uploads a supporting document in the same command. To send the order on to Neustar / SOMOS, follow up with: band portin submit .

For idempotency in agent retry loops, pass --customer-order-id with --if-not-exists. On retry, an existing order with the same customer ID is returned instead of creating a duplicate.

band portin create --numbers <...> [flags]

Examples

  band portin create --numbers +19195551234 --site 1234 --peer 5678 \
    --foc 2026-06-01T15:30:00Z --loa-authorizing-person "Jane Doe" --loa ./loa.pdf
  band portin create --numbers +19195551234 --customer-order-id agent-run-42 --if-not-exists

Options

      --customer-order-id string        Customer-supplied order identifier (used as the idempotency key with --if-not-exists)
      --foc string                      Requested FOC date (YYYY-MM-DD, or YYYY-MM-DDTHH:MM:SSZ to set an activation time)
  -h, --help                            help for create
      --if-not-exists                   If a port-in with the given --customer-order-id already exists, return it instead of creating a new one
      --loa string                      Path to an LOA or supporting document to upload alongside the order
      --loa-authorizing-person string   Name of the person authorizing the LOA
      --numbers strings                 Telephone numbers to port in, comma-separated or repeated (required)
      --peer string                     SIP peer (location) ID for the destination
      --site string                     Site (sub-account) ID for the destination

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 portin - Manage port-in orders (single, bulk, toll-free)