{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/telnyx/main/json-schema/telnyx-create-brand-schema.json",
  "title": "CreateBrand",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-brands-api-openapi.yml#/components/schemas/CreateBrand",
  "properties": {
    "businessContactEmail": {
      "description": "Business contact email.\n\nRequired if `entityType` is `PUBLIC_PROFIT`. Otherwise, it is recommended to either omit this field or set it to `null`.",
      "title": "BusinessContactEmail",
      "type": "string"
    },
    "city": {
      "description": "City name",
      "maxLength": 100,
      "title": "City",
      "type": "string"
    },
    "companyName": {
      "description": "(Required for Non-profit/private/public) Legal company name.",
      "maxLength": 100,
      "title": "Companyname",
      "type": "string"
    },
    "country": {
      "description": "ISO2 2 characters country code. Example: US - United States",
      "maxLength": 2,
      "title": "Country",
      "type": "string"
    },
    "displayName": {
      "description": "Display name, marketing name, or DBA name of the brand.",
      "maxLength": 100,
      "title": "Displayname",
      "type": "string"
    },
    "ein": {
      "description": "(Required for Non-profit) Government assigned corporate tax ID. EIN is 9-digits in U.S.",
      "maxLength": 20,
      "title": "Ein",
      "type": "string"
    },
    "email": {
      "description": "Valid email address of brand support contact.",
      "maxLength": 100,
      "title": "Email",
      "type": "string"
    },
    "entityType": {
      "allOf": [
        {
          "$ref": "#/$defs/EntityType"
        }
      ],
      "description": "Entity type behind the brand. This is the form of business establishment."
    },
    "firstName": {
      "description": "First name of business contact.",
      "maxLength": 100,
      "title": "Firstname",
      "type": "string"
    },
    "ipAddress": {
      "description": "IP address of the browser requesting to create brand identity.",
      "maxLength": 50,
      "title": "Ipaddress",
      "type": "string"
    },
    "isReseller": {
      "default": false,
      "title": "Isreseller",
      "type": "boolean"
    },
    "lastName": {
      "description": "Last name of business contact.",
      "maxLength": 100,
      "title": "Lastname",
      "type": "string"
    },
    "mobilePhone": {
      "description": "Valid mobile phone number in e.164 international format.",
      "maxLength": 20,
      "title": "Mobilephone",
      "type": "string"
    },
    "mock": {
      "default": false,
      "description": "Mock brand for testing purposes. Defaults to false.",
      "title": "Mock",
      "type": "boolean"
    },
    "phone": {
      "description": "Valid phone number in e.164 international format.",
      "maxLength": 20,
      "title": "Phone",
      "type": "string"
    },
    "postalCode": {
      "description": "Postal codes. Use 5 digit zipcode for United States",
      "maxLength": 10,
      "title": "Postalcode",
      "type": "string"
    },
    "state": {
      "description": "State. Must be 2 letters code for United States.",
      "maxLength": 20,
      "title": "State",
      "type": "string"
    },
    "stockExchange": {
      "allOf": [
        {
          "$ref": "#/$defs/StockExchange"
        }
      ],
      "description": "(Required for public company) stock exchange."
    },
    "stockSymbol": {
      "description": "(Required for public company) stock symbol.",
      "maxLength": 10,
      "title": "Stocksymbol",
      "type": "string"
    },
    "street": {
      "description": "Street number and name.",
      "maxLength": 100,
      "title": "Street",
      "type": "string"
    },
    "vertical": {
      "allOf": [
        {
          "$ref": "#/$defs/Vertical"
        }
      ],
      "description": "Vertical or industry segment of the brand."
    },
    "webhookFailoverURL": {
      "description": "Webhook failover URL for brand status updates.",
      "title": "WebhookFailoverURL",
      "type": "string"
    },
    "webhookURL": {
      "description": "Webhook URL for brand status updates.",
      "title": "WebhookURL",
      "type": "string"
    },
    "website": {
      "description": "Brand website URL.",
      "maxLength": 100,
      "title": "Website",
      "type": "string"
    }
  },
  "required": [
    "entityType",
    "displayName",
    "country",
    "email",
    "vertical"
  ],
  "type": "object",
  "$defs": {
    "EntityType": {
      "description": "Entity type behind the brand. This is the form of business establishment.",
      "enum": [
        "PRIVATE_PROFIT",
        "PUBLIC_PROFIT",
        "NON_PROFIT",
        "GOVERNMENT",
        "SOLE_PROPRIETOR"
      ],
      "title": "EntityType",
      "type": "string"
    },
    "StockExchange": {
      "description": "(Required for public company) stock exchange.",
      "enum": [
        "NONE",
        "NASDAQ",
        "NYSE",
        "AMEX",
        "AMX",
        "ASX",
        "B3",
        "BME",
        "BSE",
        "FRA",
        "ICEX",
        "JPX",
        "JSE",
        "KRX",
        "LON",
        "NSE",
        "OMX",
        "SEHK",
        "SSE",
        "STO",
        "SWX",
        "SZSE",
        "TSX",
        "TWSE",
        "VSE"
      ],
      "title": "StockExchange",
      "type": "string"
    },
    "Vertical": {
      "description": "Vertical or industry segment of the brand or campaign.",
      "enum": [
        "AGRICULTURE",
        "COMMUNICATION",
        "CONSTRUCTION",
        "EDUCATION",
        "ENERGY",
        "ENTERTAINMENT",
        "FINANCIAL",
        "GAMBLING",
        "GOVERNMENT",
        "HEALTHCARE",
        "HOSPITALITY",
        "HUMAN_RESOURCES",
        "INSURANCE",
        "LEGAL",
        "MANUFACTURING",
        "NGO",
        "POLITICAL",
        "POSTAL",
        "PROFESSIONAL",
        "REAL_ESTATE",
        "RETAIL",
        "TECHNOLOGY",
        "TRANSPORTATION"
      ],
      "title": "Vertical",
      "type": "string"
    }
  }
}