POST /hub/v1/nestedtags

Overview

Creates a tag that can be associated with any Marketing Cloud object that accepts tagging. The tag must contain a unique name. The tag can contain a description and a list of one or more nested tags.

JSON Parameters

NameTypeDescription
namestringRequiredName of the tag, up to 120 characters. The only special characters allowed are period (.) and apostrophe (').
descriptionstringDescription of the tag, up to 256 characters. The only special characters allowed are period (.), apostrophe ('), comma (,), and forward slash (/).
parentIdstringTagId that you want to be the parent of this tag. If you don’t provide a parentId, or if you specify zero as the parentId, the tag is created as a root tag with no parent.
tagsstringA list of tags to create as nested tags. To include no nested tags, omit this field. You can add and modify nested tags using the Update Nested Tags or Patch Nested Tags requests.

Usage

Example Request

This example creates a tag using only a name.

Example Response

Example Request

This example creates a parent tag with nested tags.

Example Response

Example Request

This example adds a new nested tag under an existing tag.

Example Response