band tendlc brand create

Register a 10DLC brand

Synopsis

Registers a 10DLC brand backed by an existing customer profile.

A customer profile backs exactly one brand — create a fresh profile per brand with 'band customer-profile create'; reusing one fails at brand creation.

Before submitting, this command reads the customer profile named by --customer-profile-id. Measured against production, the create endpoint itself does not reject a garbage or typo'd profile ID — it silently discards it and creates an orphan brand with no profile association that can never verify. So a 404 on that read stops the create here, naming the bad ID. A 403 does not stop it: Customer Profiles Access is a role separate from Campaign Management, so a caller entitled to create brands must not be blocked by a check they lack permission to run — it proceeds with a one-line warning on stderr instead. Any other pre-flight failure degrades the same way; this check is a guard, not a gate.

This is a non-idempotent, billable write. After an ambiguous failure — a timeout or a dropped connection — do not blindly retry: list brands filtered by --customer-profile-id-contains and reconcile against what you submitted first. Retrying blind risks a second brand against the same profile.

band tendlc brand create [flags]

Examples

  band tendlc brand create --customer-profile-id CP123 --brand-type PRIVATE_PROFIT \
    --display-name "Acme Corp" --company-name "Acme Corporation" \
    --street "123 Main St" --city Raleigh --state NC --postal-code 27601 \
    --country-code-a3 USA --phone +18885551234 --email ops@acme.com \
    --vertical RETAIL --ein 123456789 --ein-issuing-country-code-a3 USA

  band tendlc brand create --customer-profile-id CP123 --brand-type PRIVATE_PROFIT \
    ... --wait --timeout 600

Options

      --alt-business-id string               Alternate business identifier (e.g. DUNS number)
      --alt-business-id-type string          Type of the alternate business identifier
      --brand-type string                    Brand entity type: PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT, SOLE_PROPRIETOR (required)
      --business-contact-email string        Business contact email
      --city string                          City (required)
      --company-name string                  Legal company name
      --country-code-a3 string               ISO 3166-1 alpha-3 country code (required)
      --customer-profile-id string           Customer profile backing this brand (required)
      --display-name string                  Display name (required)
      --ein string                           Employer Identification Number
      --ein-issuing-country-code-a3 string   Country that issued the EIN
      --email string                         Business email address (required)
      --first-name string                    Contact first name (sole proprietor)
  -h, --help                                 help for create
      --ip-address string                    IP address the form was completed from (sole proprietor)
      --last-name string                     Contact last name (sole proprietor)
      --mobile-phone string                  Contact mobile phone (sole proprietor)
      --phone string                         Business phone number (required)
      --postal-code string                   Postal code (required)
      --state string                         State or province (required)
      --stock-exchange string                Stock exchange
      --stock-symbol string                  Stock ticker symbol
      --street string                        Street address (required)
      --timeout int                          Seconds to wait when --wait is set (default 300)
      --vertical string                      Industry vertical
      --wait                                 Block until the brand's identity status reaches a terminal state
      --website string                       Business website URL

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 tendlc brand - Manage 10DLC brands