Create a hierarchy level

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:

Argument	Type	Description	Default
`label`	`String`	Required. The display name of the hierarchy level to create.	—
`parentId`	`ID`	The 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
      }
    }
  }
}

{
  "data": {
    "createHierarchyLevel": {
      "errors": [],
      "response": {
        "id": "42",
        "label": "Advanced Level of Training",
        "parent": {
          "id": "24",
          "label": "Global region"
        }
      }
    }
  }
}

⌘I

Getting started

Integration & Concepts

Use cases

Hierarchy Management

Zapier Integration

Mobile application

Create a hierarchy level