Telnyx · Schema

CreateBrand

CommunicationsCPaaSVoiceSMSIoTTelecommunicationsMessagingArtificial IntelligenceMCPVoice AIPhone NumbersInference

Properties

Name	Type	Description
businessContactEmail	string	Business contact email. Required if `entityType` is `PUBLIC_PROFIT`. Otherwise, it is recommended to either omit this field or set it to `null`.
city	string	City name
companyName	string	(Required for Non-profit/private/public) Legal company name.
country	string	ISO2 2 characters country code. Example: US - United States
displayName	string	Display name, marketing name, or DBA name of the brand.
ein	string	(Required for Non-profit) Government assigned corporate tax ID. EIN is 9-digits in U.S.
email	string	Valid email address of brand support contact.
entityType	object	Entity type behind the brand. This is the form of business establishment.
firstName	string	First name of business contact.
ipAddress	string	IP address of the browser requesting to create brand identity.
isReseller	boolean
lastName	string	Last name of business contact.
mobilePhone	string	Valid mobile phone number in e.164 international format.
mock	boolean	Mock brand for testing purposes. Defaults to false.
phone	string	Valid phone number in e.164 international format.
postalCode	string	Postal codes. Use 5 digit zipcode for United States
state	string	State. Must be 2 letters code for United States.
stockExchange	object	(Required for public company) stock exchange.
stockSymbol	string	(Required for public company) stock symbol.
street	string	Street number and name.
vertical	object	Vertical or industry segment of the brand.
webhookFailoverURL	string	Webhook failover URL for brand status updates.
webhookURL	string	Webhook URL for brand status updates.
website	string	Brand website URL.

View JSON Schema on GitHub

JSON Schema

{
  "$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"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/telnyx-create-brand"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.