Skip to content

team-put-teams.md

Latest commit

 

History

History
176 lines (135 loc) · 5.57 KB

team-put-teams.md

File metadata and controls

176 lines (135 loc) · 5.57 KB
title Create team from group
description Create a new team under a group.
author MSFTRickyCastaneda
ms.localizationpriority high
ms.subservice teams
doc_type apiPageType
ms.date 09/16/2024

Create team from group

Namespace: microsoft.graph

Create a new team under a group. In order to create a team, the group must have at least one owner.

If the group was created less than 15 minutes ago, calls to create a team might fail with a 404 Not Found error code because the group information didn't fully replicate.

Tip

We recommend that you retry this API call up to three times, with a 10‑second delay between attempts. If the call still fails after three retries, wait at least 15 minutes after the group was created before you try again.

Note

SharePoint provisioning doesn't occur in real time, it's a background process. The completion of the provisioning can't be determined.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

Note: This API supports admin permissions. Microsoft Teams service admins can access groups that they are not a member of.

HTTP request

PUT /groups/{id}/team

Request headers

Header Value
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json

Request body

In the request body, supply a JSON representation of a team object.

Response

If successful, this method should return a 201 Created response code and a team object in the response body.

Example

Request

The following example shows a request.

HTTP

PUT https://graph.microsoft.com/v1.0/groups/{id}/team
Content-type: application/json

{
  "memberSettings": {
    "allowCreatePrivateChannels": true,
    "allowCreateUpdateChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict"
  }
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-type: application/json

{
  "memberSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true,
    "allowAddRemoveApps": true,
    "allowCreateUpdateRemoveTabs": true,
    "allowCreateUpdateRemoveConnectors": true
  },
  "guestSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true,
    "allowOwnerDeleteMessages": true,
    "allowTeamMentions": true,
    "allowChannelMentions": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict",
    "allowStickersAndMemes": true,
    "allowCustomMemes": true
  }
}

Related content