> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wavix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Register a 10DLC Brand

> Registers a 10DLC Brand. TCR automatically verifies the brand identity. Only brands with `VERIFIED` or `VETTED_VERIFIED` identity status can register 10DLC Campaigns.



## OpenAPI

````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml post /v3/10dlc/brands
openapi: 3.1.0
info:
  title: Wavix APIs
  description: >-
    Wavix provides robust APIs that let you integrate voice and text messaging
    features directly into your app. Send text, place calls, and access detailed
    reports  programmatically.
  termsOfService: https://wavix.com/terms-and-conditions
  license:
    name: MIT
    identifier: MIT
  contact:
    name: Wavix
    url: https://wavix.com
    email: support@wavix.com
  version: '1.0'
servers:
  - url: https://api.wavix.com
    description: https://api.wavix.com
    variables: {}
security:
  - bearerAuth: []
tags:
  - name: SIP trunks
    description: SIP trunks
  - name: Buy
    description: Numbers
  - name: Cart
    description: Numbers
  - name: My numbers
    description: Numbers
  - name: Billing
    description: Billing, transactions, and invoices
  - name: Profile
    description: Account profile and customer information
  - name: CDRs
    description: Call detail records and call history
  - name: Speech Analytics
    description: Call transcription and speech analytics
  - name: SMS and MMS
    description: Messaging
  - name: Number Validator
    description: Phone number validation
  - name: Link shortener
    description: Short link and click metrics
  - name: 2FA
    description: Two-factor authentication
  - name: 10DLC
    description: 10DLC Campaigns and Brands
  - name: API Keys
    description: API key management
  - name: Call webhooks
    description: Webhook configuration for call events
  - name: Call control
    description: Programmable Voice
  - name: Call streaming
    description: Real-time call audio streaming over WebSocket
  - name: Call recording
    description: Call recording
  - name: Sub-accounts
    description: Sub-account management
  - name: Voice campaigns
    description: Outbound voice campaigns
  - name: Wavix Embeddable
    description: WebRTC embeddable widget
paths:
  /v3/10dlc/brands:
    post:
      tags:
        - 10DLC
      summary: Register a 10DLC Brand
      description: >-
        Registers a 10DLC Brand. TCR automatically verifies the brand identity.
        Only brands with `VERIFIED` or `VETTED_VERIFIED` identity status can
        register 10DLC Campaigns.
      operationId: ten_dlc_brands_create
      parameters: []
      requestBody:
        description: Attributes for the new 10DLC Brand.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TenDLCBrandCreateRequest'
        required: true
      responses:
        '201':
          description: Returns the registered 10DLC Brand.
          headers: {}
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/TenDLCBrand'
                  - example:
                      brand_id: BM20QP9
                      city: Miami
                      company_name: Company legal name
                      country: US
                      created_at: '2024-07-24T08:10:49'
                      dba_name: New Brand
                      ein_taxid: '99999999'
                      ein_taxid_country: US
                      email: support@brand.com
                      entity_type: PRIVATE_PROFIT
                      feedback: null
                      first_name: John
                      last_name: Dow
                      mock: false
                      phone_number: '12123450099'
                      state_or_province: FL
                      status: REVIEW
                      stock_exchange: null
                      stock_symbol: null
                      street_address: 10, Street Name
                      updated_at: '2024-07-24T08:10:49'
                      vertical: HEALTHCARE
                      website: https://brand.com
                      zip: '12345'
              examples:
                default:
                  value:
                    brand_id: BM20QP9
                    city: Miami
                    company_name: Company legal name
                    country: US
                    created_at: '2024-07-24T08:10:49'
                    dba_name: New Brand
                    ein_taxid: '99999999'
                    ein_taxid_country: US
                    email: support@brand.com
                    entity_type: PRIVATE_PROFIT
                    feedback: null
                    first_name: John
                    last_name: Dow
                    mock: false
                    phone_number: '12123450099'
                    state_or_province: FL
                    status: REVIEW
                    stock_exchange: null
                    stock_symbol: null
                    street_address: 10, Street Name
                    updated_at: '2024-07-24T08:10:49'
                    vertical: HEALTHCARE
                    website: https://brand.com
                    zip: '12345'
        '400':
          $ref: '#/components/responses/BadRequestErrorResponse'
        '403':
          description: Returns when the 10DLC feature is disabled for the account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
              examples:
                success:
                  summary: Successful response
                  value:
                    success: false
                    message: Request failed. The feature is disabled for the account.
      deprecated: false
      security:
        - bearerAuth:
            - campaigns:write
components:
  schemas:
    TenDLCBrandCreateRequest:
      title: TenDLCBrandCreateRequest
      type: object
      description: 10DLC Brand registration request
      additionalProperties: false
      required:
        - dba_name
        - company_name
        - entity_type
        - vertical
        - ein_taxid
        - ein_taxid_country
        - first_name
        - last_name
        - phone_number
        - email
        - street_address
        - city
        - state_or_province
        - country
        - zip
      properties:
        dba_name:
          type: string
          description: Brand name or DBA
          maxLength: 255
          example: Brand
        company_name:
          type: string
          description: Legal name of the company
          maxLength: 255
          example: Company
        entity_type:
          type: string
          description: >-
            Legal entity type of the company. One of `PRIVATE_PROFIT` (privately
            held for-profit company), `PUBLIC_PROFIT` (publicly traded
            for-profit company), `NON_PROFIT` (non-profit organization), or
            `GOVERNMENT` (government entity).
          enum:
            - PRIVATE_PROFIT
            - PUBLIC_PROFIT
            - NON_PROFIT
            - GOVERNMENT
          example: PUBLIC_PROFIT
        vertical:
          type: string
          description: |-
            Business segment the Brand operates in. One of:

            - `HEALTHCARE` — healthcare.
            - `PROFESSIONAL` — professional services.
            - `RETAIL` — retail.
            - `TECHNOLOGY` — technology.
            - `EDUCATION` — education.
            - `FINANCIAL` — financial services.
            - `NON_PROFIT` — non-profit organizations.
            - `GOVERNMENT` — government entities.
            - `OTHER` — any segment not listed above.
          enum:
            - HEALTHCARE
            - PROFESSIONAL
            - RETAIL
            - TECHNOLOGY
            - EDUCATION
            - FINANCIAL
            - NON_PROFIT
            - GOVERNMENT
            - OTHER
          example: PROFESSIONAL
        ein_taxid:
          type: string
          description: >-
            IRS Employee Identification Number (EIN) for US-based or foreign
            companies with EIN. The numeric portion of Tax ID for companies
            incorporated in other countries.
          maxLength: 21
          example: 12-2142342
        ein_taxid_country:
          type: string
          description: 2-letter ISO country code of the Tax ID issuing country
          minLength: 2
          maxLength: 2
          example: US
        website:
          type: string
          description: The website of the business
          maxLength: 255
          example: Tess.com
        stock_symbol:
          type:
            - string
            - 'null'
          description: The stock symbol of the Brand. For PUBLIC_PROFIT Brands only.
          maxLength: 10
        stock_exchange:
          type:
            - string
            - 'null'
          description: The stock exchange code. For PUBLIC_PROFIT Brands only.
          maxLength: 10
          example: NASDAQ
        first_name:
          type: string
          description: The first name of the business contact
          maxLength: 100
          example: John
        last_name:
          type: string
          description: The last name of the business contact
          maxLength: 100
          example: Dow
        phone_number:
          type: string
          description: The support contact telephone in E.164 format
          maxLength: 20
          example: '12046661776'
        email:
          type: string
          description: The email address of the support contact
          format: email
          maxLength: 100
          example: support@brand.com
        street_address:
          type: string
          description: Street name and house number
          maxLength: 100
          example: 10, City Name
        city:
          type: string
          description: The city name
          maxLength: 100
          example: Miami
        state_or_province:
          type:
            - string
            - 'null'
          description: State or province. For the United States, use 2 character codes.
          maxLength: 20
          example: AL
        zip:
          type: string
          description: The business zip or postal code
          maxLength: 10
          example: '12345'
        country:
          type: string
          description: 2-letter ISO country code the business address
          minLength: 2
          maxLength: 2
          example: US
        mock:
          type: boolean
          description: >-
            Indicates a mock Brand. Mock Brands are for testing purposes only;
            production traffic with mock Brands is prohibited.
          default: false
          example: false
      oneOf:
        - description: PUBLIC_PROFIT brands must provide stock_symbol and stock_exchange.
          properties:
            entity_type:
              const: PUBLIC_PROFIT
          required:
            - stock_symbol
            - stock_exchange
        - description: >-
            Non-PUBLIC_PROFIT brands must not include stock_symbol or
            stock_exchange.
          properties:
            entity_type:
              enum:
                - PRIVATE_PROFIT
                - NON_PROFIT
                - GOVERNMENT
            stock_symbol:
              type: 'null'
            stock_exchange:
              type: 'null'
      example:
        dba_name: Brand
        company_name: Company
        entity_type: PUBLIC_PROFIT
        vertical: PROFESSIONAL
        ein_taxid: 12-2142342
        ein_taxid_country: US
        website: Tess.com
        stock_symbol: null
        stock_exchange: NASDAQ
        first_name: John
        last_name: Doe
        phone_number: '12046661776'
        email: support@brand.com
        street_address: 10, Street name
        city: Miami
        state_or_province: AL
        zip: '12345'
        country: US
        mock: false
    TenDLCBrand:
      title: TenDLCBrand
      required:
        - brand_id
        - dba_name
        - company_name
        - entity_type
        - vertical
        - ein_taxid
        - ein_taxid_country
        - status
        - first_name
        - last_name
        - phone_number
        - email
        - street_address
        - city
        - country
        - zip
        - feedback
        - created_at
        - updated_at
      type: object
      additionalProperties: false
      properties:
        brand_id:
          type: string
          description: Unique identifier of the Brand assigned by the registry.
          example: BM20QP9
        dba_name:
          type: string
          description: Doing-business-as name, or the public-facing brand name.
          example: Brand
        company_name:
          type: string
          description: Registered legal name of the company that owns the Brand.
          example: Company
        entity_type:
          allOf:
            - $ref: '#/components/schemas/TenDLCBrandEntityType'
            - description: Company entity type.
              example: PRIVATE_PROFIT
        vertical:
          type: string
          description: Industry vertical the Brand operates in.
          example: HEALTHCARE
        ein_taxid:
          type: string
          description: >-
            IRS Employer Identification Number (EIN) or other tax ID of the
            company.
          example: '999999999'
        ein_taxid_country:
          type: string
          description: ISO 3166-1 alpha-2 country code where the Tax ID was issued.
          example: US
        status:
          allOf:
            - $ref: '#/components/schemas/TenDLCBrandIdentityVerificationStatus'
            - description: Brand identity verification status.
              example: VERIFIED
        website:
          type:
            - string
            - 'null'
          description: Business website URL.
          example: https://brand.com
        stock_symbol:
          type:
            - string
            - 'null'
          description: >-
            Stock ticker symbol of the company. Required for publicly traded
            companies.
        stock_exchange:
          type:
            - string
            - 'null'
          description: >-
            Code of the stock exchange the company is listed on. Required for
            publicly traded companies.
        first_name:
          type: string
          description: Business contact first name.
          example: John
        last_name:
          type: string
          description: Business contact last name.
          example: Dow
        phone_number:
          type: string
          description: Support contact phone number in E.164 format.
          example: '12123450099'
        email:
          type: string
          description: Support contact email address.
          example: support@brand.com
        street_address:
          type: string
          description: Street address of the business.
          example: 10, City Name
        city:
          type: string
          description: City of the business address.
          example: Miami
        state_or_province:
          type:
            - string
            - 'null'
          description: State or province of the business address.
          example: FL
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code of the business address.
          example: US
        zip:
          type: string
          description: ZIP or postal code of the business address.
          example: '12345'
        feedback:
          type:
            - string
            - 'null'
          description: >-
            Feedback from the identity verification process explaining the
            current `status`.
        mock:
          type: boolean
          description: Indicates whether the Brand is a mock brand for testing.
          default: false
          example: false
        created_at:
          type: string
          description: Timestamp when the Brand was created, in ISO 8601 format.
          example: '2024-07-24T08:29:09'
        updated_at:
          type: string
          description: Timestamp when the Brand was last updated, in ISO 8601 format.
          example: '2024-07-24T08:29:09'
      description: >-
        Represents a 10DLC brand registered for application-to-person messaging.
        A Brand identifies the business behind one or more messaging campaigns.
      example:
        brand_id: BM20QP9
        city: Miami
        company_name: Company legal name
        country: US
        created_at: '2024-07-24T08:10:49'
        dba_name: New Brand
        ein_taxid: '12345'
        ein_taxid_country: US
        email: support@brand.com
        entity_type: PRIVATE_PROFIT
        feedback: null
        first_name: John
        last_name: Dow
        mock: false
        phone_number: '12123450099'
        state_or_province: FL
        status: VERIFIED
        stock_exchange: null
        stock_symbol: null
        street_address: 10, Street name
        updated_at: '2024-07-24T08:29:09'
        vertical: HEALTHCARE
        website: https://brand.com
        zip: '12345'
    AccountErrorResponse:
      title: AccountErrorResponse
      required:
        - success
        - message
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether the request was successful
          example: false
        message:
          type: string
          description: Human-readable error description
          example: Request failed. The feature is disabled for the account.
      description: The feature is disabled for the account.
    TenDLCBrandEntityType:
      title: TenDLCBrandEntityType
      enum:
        - PRIVATE_PROFIT
        - PUBLIC_PROFIT
        - NON_PROFIT
        - GOVERNMENT
      type: string
      description: >-
        Legal entity type of the 10DLC Brand. One of `PRIVATE_PROFIT` (privately
        held for-profit company), `PUBLIC_PROFIT` (publicly traded for-profit
        company), `NON_PROFIT` (non-profit organization), or `GOVERNMENT`
        (government entity).
      example: PRIVATE_PROFIT
    TenDLCBrandIdentityVerificationStatus:
      title: TenDLCBrandIdentityVerificationStatus
      enum:
        - REVIEW
        - VERIFIED
        - UNVERIFIED
        - VETTED_VERIFIED
        - SUSPENDED
      type: string
      description: |-
        Identity verification status of the 10DLC Brand. One of:

        - `REVIEW` — verification is in progress.
        - `VERIFIED` — the Brand passed standard verification.
        - `UNVERIFIED` — verification has not succeeded.
        - `VETTED_VERIFIED` — the Brand also passed third-party vetting.
        - `SUSPENDED` — the Brand is blocked from sending.
    ValidationErrorResponse:
      title: ValidationErrorResponse
      type: object
      properties:
        success:
          type: boolean
          description: >-
            Indicates whether the request was successful. Always `false` for
            this error.
          example: false
        message:
          type: string
          description: >-
            Human-readable description naming the missing or invalid request
            parameter.
          example: Missing or invalid parameter <param_name>
  responses:
    BadRequestErrorResponse:
      description: Request failed. Missing or invalid parameter <param_name>
      headers: {}
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        Wavix API key. Pass as `Authorization: Bearer <api_key>`. Keys support
        per-resource scopes (none / read / write). See [Restricted keys and
        scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes).

````