---
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.

## Changes

> 62 revisions in range; 2 could not be searched.

- **2026-05-06** `85e27cfef60d` — 2 info
  - added the new optional request property `notification_setting`
  - added the optional property `notification_setting` to the response with the `201` status

[Change history](https://skmtc.dev/github/apis/enterprise-cloud/changes/enterprises/:enterprise/teams/post.md)

---

[API](https://skmtc.dev/github/apis/enterprise-cloud.md) · [All operations](https://skmtc.dev/github/apis/enterprise-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/github/enterprise-cloud/revisions/6020c72ba337/schema)