# Teams

**URL:** https://heroiclabs.com/docs/hiro/dart/teams/
**Keywords:** teams, hiro
**Categories:** hiro, dart, teams

---


# Teams

Read more about the Teams system in Hiro [here](../../concepts/teams/).

## Create a team

Create a team which other players can join.

```dart
var request = TeamCreateRequest();
request.name = "Example team";
request.desc = "Example description";
request.open = true;
request.icon = "icon.png";
request.lang_tag = "en";
request.setup_metadata = "{}"; // Must be a valid JSON string.

var team = await hiro.teamsCreate(session!, request);
print(team);
```

## List one or more teams

List one or more teams which the player can join.

```dart
var request = TeamListRequest();
request.cursor = "";
request.location = "UK";
request.limit = 100;

var team_list = await hiro.teamsList(session!, request);
print(team_list);
```

## Search for a team

Search for a team by name or optional short code.

```dart
var request = TeamSearchRequest();
request.input = "heroes";
request.limit = 100;

var team_list = await hiro.teamSearch(session!, request);
print(team_list);
```

## Send team chat message

Write a chat message to the Team's chat channel.

```dart
var request = TeamWriteChatMessageRequest();
request.id = "team_1";
request.content = "{\"message\":\"Hey everyone!\"}";

var channel_message_ack = await hiro.teamsWriteChatMessage(session!, request);
print(channel_message_ack);
```