Only users with the ADMINISTRATOR scope in the current context can create hierarchy levels. Make sure your API token grants administrator privileges. See Understanding Scopes for more information.
To create a new hierarchy level, use the createHierarchyLevel mutation. Access policy:
  • The API user context must have permission to create hierarchy levels.
  • If parentId is provided and is not 0, a hierarchy level with this ID must exist.
The single argument accepted by this mutation is hierarchyLevel, an object with the following properties:
ArgumentTypeDescriptionDefault
labelStringRequired. The display name of the hierarchy level to create.—
parentIdIDThe parent hierarchy level ID. Use 0 or omit the field to create a top‑level hierarchy.0
To create a top‑level hierarchy level, set parentId to 0 or omit it.
mutation createHierarchyLevel {
  createHierarchyLevel(hierarchyLevel: {
    label: "Advanced Level of Training",
    parentId: "24"
  }){
    errors
    response {
      id
      label
      parent {
        id
        label
      }
    }
  }
}