---
title: "Hierarchy Team"
canonical_url: "https://docs.getdx.com/webapi/types/hierarchy-team/"
md_url: "https://docs.getdx.com/webapi/types/hierarchy-team.md"
last_updated: "2026-05-08"
---

# Hierarchy Team
A hierarchy team is a team in DX that has an identifier provided by the DX customer as well as its parent and contributors.

## Example

```json
{
  "name": "Team name",
  "reference_id": "your-unique-id",
  "team_lead_email": "team_lead@your_domain.com",
  "parent_team_reference_id": "your-parent-team-id",
  "parent_team_name": "Parent team",
  "contributors": [
    "team_member1@your_domain.com",
    "team_member2@your_domain.com"
  ]
}
```

## Properties

| Key                        | Type   | Description                                                                                                                                                                   |
| -------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `reference_id`             | string | ID for the team.                                                                                                                                                              |
| `name`                     | string | Name of the team.                                                                                                                                                             |
| `team_lead_email`          | string | Email address of team lead for the team. The user must exist in DX.                                                                                                           |
| `parent_team_reference_id` | string | Identifier of the parent team for the row. If this value is blank then the team object will be considered a top level team. Must be present if `parent_team_name` is present. |
| `parent_team_name`         | string | Name of the parent team. Must be present if `parent_team_reference_id` is present.                                                                                            |
| `contributors`             | Array  | Email addresses of users who are members of the team. If the email addresses do not exist in DX the endpoint will silently ignore them.                                       |
---

## Sitemap

[Overview of all docs pages](/llms.txt)