---
title: "Create an enterprise team"
method: POST
path: "/enterprises/{enterprise}/teams"
tags: ["enterprise-teams"]
---

# Create an enterprise team

`POST /enterprises/{enterprise}/teams`

To create an enterprise team, the authenticated user must be an owner of the enterprise.

## Path parameters

- `enterprise` string, required

## Request body

- object
  - `name` string, required — The name of the team.
  - `description` string, nullable — A description of the team.
  - `sync_to_organizations` 'all' | 'disabled' — Retired: this field is no longer supported. Whether the enterprise team should be reflected in each organization. This value cannot be set.
  - `organization_selection_type` 'disabled' | 'selected' | 'all' — Specifies which organizations in the enterprise should have access to this team. Can be one of `disabled`, `selected`, or `all`. `disabled`: The team is not assigned to any organizations. This is the default when you create a new team. `selected`: The team is assigned to specific organizations. You can then use the [add organization assignments API](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-teams/enterprise-team-organizations#add-organization-assignments) endpoint. `all`: The team is assigned to all current and future organizations in the enterprise.
  - `group_id` string, nullable — The ID of the IdP group to assign team membership with. You can get this value from the [REST API endpoints for SCIM](https://docs.github.com/enterprise-cloud@latest/rest/scim#list-provisioned-scim-groups-for-an-enterprise).
  - `notification_setting` 'notifications_enabled' | 'notifications_disabled' — The notification setting the team is set to. The options are: * `notifications_enabled` - team members receive notifications when the team is @mentioned. * `notifications_disabled` - no one receives notifications. Default: `notifications_enabled`

## Response `201`

Response

- EnterpriseTeam — Group of enterprise owners and/or members
  - `id` integer, required
  - `name` string, required
  - `description` string
  - `slug` string, required
  - `url` string, uri, required
  - `sync_to_organizations` string — Retired: this field will not be returned with GHEC enterprise teams.
  - `organization_selection_type` string
  - `group_id` string, nullable, required
  - `group_name` string, nullable — Retired: this field will not be returned with GHEC enterprise teams.
  - `html_url` string, uri, required
  - `members_url` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `notification_setting` 'notifications_enabled' | 'notifications_disabled' — Whether team members will receive notifications when the team is mentioned.

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)