# Create a team

Copy as Markdown[View as Markdown](/docs/development/guides/owners/create-team.md)

***

A team represents a group of people that owns, maintains, or can answer questions about parts of your architecture.

![Example team page](/assets/images/example-cdc1d160433644a27f3e3af18ef3a784.png)

## Adding a new team[​](#adding-a-new-team "Direct link to Adding a new team")

### Automatic Creation[​](#automatic-creation "Direct link to Automatic Creation")

Copy this prompt and paste it into your coding agent. Your agent can create the team file, add the right frontmatter, and optionally create user files for team members.

### Manual Creation[​](#manual-creation "Direct link to Manual Creation")

Teams live in the `/teams` folder.

Create one `.mdx` file for each team.

* teams
  <!-- -->
  /
  * payments-platform.mdx

## Create the team file[​](#create-the-team-file "Direct link to Create the team file")

Create a team file with frontmatter and markdown content.

/teams/payments-platform.mdx

```
---
# id of the team, used for references from resources
id: payments-platform

# display name for the team
name: Payments Platform

# short summary of the team
summary: Owns payment processing, refunds, and payment platform reliability.

# users that belong to the team
members:
  - dboyne
  - asmith

# optional email address to contact the team
email: payments@example.com

# optional Slack URL to contact the team
slackDirectMessageUrl: https://yourteam.slack.com/channels/payments-platform
---

## Overview

The Payments Platform team owns payment processing, refund workflows, and the operational systems that support payments across the organization.
```

Once the file is added, the team appears in EventCatalog and can be referenced by resources.

## Add team members[​](#add-team-members "Direct link to Add team members")

Team members reference users by id. User files live in the `/users` folder.

* users

  <!-- -->

  /

  * dboyne.mdx
  * asmith.mdx

* teams
  <!-- -->
  /
  * payments-platform.mdx

## Next steps[​](#next-steps "Direct link to Next steps")

* [Create a user](/docs/development/guides/owners/create-user.md)
* [Review the teams reference](/docs/development/guides/owners/teams-reference.md)
* [Sync teams from external systems](/docs/development/guides/owners/automated-teams-and-users.md)