---
updatedAt: 2026-06-05T20:14:09.000Z
---

# Create Content Display Names

Create Content Display Names

<h3 style="color: #071d49;">Note: Some carriers only allow up 15 characters. To make sure your calls brand on all available networks, please add a 15 character (or less) display to shortname under asset.</h3>


# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "version": "1.0",
    "title": "Branded Communications Exchange",
    "termsOfService": "https://firstorion.com/terms-use/",
    "x-logo": {
      "url": "https://firstorion.com/wp-content/themes/salient-child/img/logo-icon-blue.svg",
      "backgroundColor": "rgba(0,0,0,0)",
      "altText": "First Orion Logo"
    },
    "description": "> Please avoid using APIs that are marked `deprecated`. While the functions / endpoints will work for the time being, they will be deprecated in the next major release of the APIs.\n",
    "license": {
      "url": "change this and name",
      "name": "Apache 2.0"
    }
  },
  "servers": [
    {
      "url": "https://api.firstorion.com",
      "description": "Production Environment"
    },
    {
      "url": "https://api.forp-lab.com",
      "description": "Integration Environment"
    }
  ],
  "components": {
    "schemas": {
      "businessId": {
        "type": "string",
        "description": "System generated unique identifier for the business",
        "example": "719d140e-fd6c-4d59-9241-3dee71b38320"
      },
      "note": {
        "type": "string",
        "description": "User generated note about the callername. This is for internal use / reference Only",
        "maximum": 256,
        "example": "Display Name for Fraud Detection team's outgoing calls"
      },
      "longName": {
        "type": "string",
        "description": "32 character display name to be shown when calls are being made",
        "minimum": 2,
        "maximum": 32,
        "example": "Good Invest - Fraud Alert"
      },
      "shortName": {
        "type": "string",
        "description": "Display name used in networks where only 15 characters are available. Needed to make sure those calls get branded.",
        "maximum": 15,
        "example": "Fraud Alert"
      },
      "asset": {
        "type": "object",
        "description": "Content/assets displayed to the end user when branded call is delivered to a phone",
        "properties": {
          "contentId": {
            "type": "string",
            "example": "a813e38c-8730-4ce4-80b1-0bead1186e4d"
          },
          "resellerId": {
            "type": "string",
            "example": "186e4d8c-8730-3dee-80b1-4d59d11880b1"
          },
          "businessId": {
            "type": "string",
            "example": "719d140e-fd6c-4d59-9241-3dee71b38320"
          },
          "type": {
            "type": "string",
            "example": "DISPLAY_NAME"
          },
          "status": {
            "type": "string",
            "example": "UNDER_REVIEW"
          },
          "lastUpdated": {
            "type": "string",
            "example": "1702249909"
          },
          "lastUpdatedBy": {
            "type": "string",
            "example": "VETTING_ORCHESTRATOR"
          },
          "note": {
            "$ref": "#/components/schemas/note"
          },
          "longName": {
            "$ref": "#/components/schemas/longName"
          },
          "shortName": {
            "$ref": "#/components/schemas/shortName"
          }
        }
      },
      "PostCallerNameAsset": {
        "type": "object",
        "properties": {
          "longName": {
            "$ref": "#/components/schemas/longName"
          },
          "shortName": {
            "$ref": "#/components/schemas/shortName"
          },
          "note": {
            "$ref": "#/components/schemas/note"
          }
        },
        "required": [
          "longName"
        ]
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Unauthorized"
      },
      "Forbidden": {
        "description": "Forbidden"
      },
      "OneOrMoreIdsBadRequest": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 400
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "path validation failed: one or more IDs in the URL are invalid"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "ProgramResourceNotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 404
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "rpc error: code = NotFound desc = program not found"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "CallerNameConflict": {
        "description": "Conflict",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 409
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "rpc error: code = AlreadyExists desc = cnam channel already exists"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Authentication",
      "tags": [
        "Authentication",
        "OAuth2.0"
      ]
    },
    {
      "name": "Businesses",
      "tags": [
        "Businesses",
        "Business Addresses",
        "Business Contacts",
        "Business Images",
        "Business API Keys",
        "Business Units"
      ]
    },
    {
      "name": "Phone Numbers",
      "tags": [
        "Business Phone Numbers",
        "Business Unit Phone Numbers",
        "CallerName aNumbers"
      ]
    },
    {
      "name": "Programs",
      "tags": [
        "Programs",
        "Schedules"
      ]
    },
    {
      "name": "Program Delivery Channels",
      "tags": [
        "Delivery Channels",
        "CallerName",
        "CallerImage",
        "Blocking",
        "Engage SDK"
      ]
    },
    {
      "name": "Call Authentication",
      "tags": [
        "Call Authentication",
        "Call Authentication V2",
        "PreCall Engage SDK"
      ]
    },
    {
      "name": "Reference Data",
      "tags": [
        "Employee Count Ranges",
        "Daily Call Count Ranges",
        "Industries",
        "Call Purposes"
      ]
    },
    {
      "name": "Utilities",
      "tags": [
        "Phone Number Verification"
      ]
    }
  ],
  "paths": {
    "/exchange/v1/businesses/{businessId}/content/displayNames": {
      "summary": "CallerName Delivery Channel",
      "parameters": [
        {
          "name": "Authorization",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "example": "<token>",
            "description": "Access Token"
          }
        },
        {
          "name": "businessId",
          "in": "path",
          "required": true,
          "schema": {
            "$ref": "#/components/schemas/businessId"
          }
        }
      ],
      "post": {
        "summary": "Create Content Display Names",
        "description": "Create Content Display Names\n\n<h3 style=\"color: #071d49;\">Note: Some carriers only allow up 15 characters. To make sure your calls brand on all available networks, please add a 15 character (or less) display to shortname under asset.</h3>\n",
        "operationId": "PostContentDisplayNames",
        "tags": [
          "Business Content Display Names"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostCallerNameAsset"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "body": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/asset"
                      }
                    },
                    "error": {
                      "type": "string",
                      "example": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/OneOrMoreIdsBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/ProgramResourceNotFound"
          },
          "409": {
            "$ref": "#/components/responses/CallerNameConflict"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```