---
title: "Create a team"
method: POST
path: "/api/v2/team"
tags: ["Teams"]
---

# Create a team

`POST /api/v2/team`

Create a new team.
User IDs passed through the `users` relationship field are added to the team.

## Request body

- TeamCreateRequest — Request to create a team
  - `data` TeamCreate, required — Team create
    - `attributes` TeamCreateAttributes, required — Team creation attributes
      - `avatar` string, nullable — Unicode representation of the avatar for the team, limited to a single grapheme
      - `banner` integer, nullable — Banner selection for the team
      - `description` string — Free-form markdown description/content for the team's homepage
      - `handle` string, required — The team's identifier
      - `hidden_modules` string[] — Collection of hidden modules for the team
      - `name` string, required — The name of the team
      - `visible_modules` string[] — Collection of visible modules for the team
    - `relationships` TeamCreateRelationships — Relationships formed with the team on creation
      - `users` RelationshipToUsers — Relationship to users.
        - `data` RelationshipToUserData[], required — Relationships to user objects.
          - `id` string, required — A unique identifier that represents the user.
          - `type` 'users', required — Users resource type.
    - `type` 'team', required — Team type

## Response `201`

CREATED

- TeamResponse — Response with a team
  - `data` Team — A team
    - `attributes` TeamAttributes, required — Team attributes
      - `avatar` string, nullable — Unicode representation of the avatar for the team, limited to a single grapheme
      - `banner` integer, nullable — Banner selection for the team
      - `created_at` string, date-time — Creation date of the team
      - `description` string, nullable — Free-form markdown description/content for the team's homepage
      - `handle` string, required — The team's identifier
      - `hidden_modules` string[], nullable — Collection of hidden modules for the team
      - `is_managed` boolean — Whether the team is managed from an external source
      - `link_count` integer — The number of links belonging to the team
      - `modified_at` string, date-time — Modification date of the team
      - `name` string, required — The name of the team
      - `summary` string, nullable — A brief summary of the team, derived from the `description`
      - `user_count` integer — The number of users belonging to the team
      - `visible_modules` string[], nullable — Collection of visible modules for the team
    - `id` string, required — The team's identifier
    - `relationships` TeamRelationships — Resources related to a team
      - `team_links` RelationshipToTeamLinks — Relationship between a team and a team link
        - `data` RelationshipToTeamLinkData[] — Related team links
          - `id` string, required — The team link's identifier
          - `type` 'team_links', required — Team link type
        - `links` TeamRelationshipsLinks — Links attributes.
          - `related` string — Related link.
      - `user_team_permissions` RelationshipToUserTeamPermission — Relationship between a user team permission and a team
        - `data` RelationshipToUserTeamPermissionData, nullable — Related user team permission data
          - `id` string, required — The ID of the user team permission
          - `type` 'user_team_permissions', required — User team permission type
        - `links` TeamRelationshipsLinks — Links attributes.
          - `related` string — Related link.
    - `type` 'team', required — Team type

## Other responses

- `403` — Forbidden
- `409` — API error response.
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)