Skip to main content
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
      }
    }
  }
}