# Create Team From Group

> `UiPath.Teams.Activities.Teams.CreateTeamFromGroup`

`UiPath.Teams.Activities.Teams.CreateTeamFromGroup`

The **Create Team from Group** activity calls the Microsoft Graph [CreateTeamFromGroup](https://docs.microsoft.com/en-us/graph/api/team-put-teams?view=graph-rest-beta&tabs=http) API to create a new team based on an existing group in your Azure directory (**GroupId**). The new team is created using a standard [template](https://docs.microsoft.com/en-us/MicrosoftTeams/get-started-with-teams-templates#what-are-base-template-types), the name of the specified group, and it includes all group members.

After the activity creates your new team, it outputs its properties a `Team` object (**Team**) that you can use input variables in subsequent activities (e.g., `Team.Id` in [Get Channels](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-get-channels#get-channels), [Update Channel](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-update-channel#update-channel), etc.).

## How It Works

The following steps and message sequence diagram is an example how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-setup#setup) steps.
2. Add the [Microsoft Teams Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-scope#microsoft-teams-scope) activity to your project.
3. Add the **Create Team from Group** activity inside the **Microsoft Teams Scope** activity.
4. Enter values for the [Input](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-create-team-from-group#input) properties.
5. Create and enter a `Team` variable for your [Output](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-create-team-from-group#output) property.
6. Run the activity.
   * Your input property values are sent to the [CreateTeamFromGroup](https://docs.microsoft.com/en-us/graph/api/team-put-teams?view=graph-rest-beta&tabs=http) API.
   * The API returns the `Team` value to your output property variable.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-33967-430df646-c8641b76.webp)

## Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-33827-75afec41-17cab18b.webp)

### Common

#### DisplayName

The display name of the activity.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | *Create Team From Group* |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | N/A |

### Input

#### GroupId

The Object Id of the Azure directory group that you want to use to create your team.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | No |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | Enter the Object Id of your group. You can find your Object Id in your Azure Directory > Groups - All Groups > "Group" (see image below). |

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-34519-9dfb0d15-b8c7687b.webp)

### Output

#### Team

The `Team` object that represents your created team.

| Attributes | Details |
| --- | --- |
| **Type** | `Team` |
| **Required** | No (required if you plan to use the output data in subsequent activities) |
| **Default value** | Empty |
| **Allowed values** | Enter a `Team` variable. |
| **Notes** | The variable you create for this property can be used as an input variable in subsequent activities(e.g., `Team.Id` in [Get Channels](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-get-channels#get-channels), [Update Channel](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-update-channel#update-channel), etc.).  The `Team` object includes multiple [properties](https://docs.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-beta#properties) and [relationships](https://docs.microsoft.com/en-us/graph/api/resources/team?view=graph-rest-beta#relationships) that you can use in other activities.The example image below shows some of the properties that you can return. Note - some properties listed in the designer are not applicable to the `Team` object (e.g., `Template`). For a list of the applicable `Team` properties, visit the links above. |

## Example

The following image shows an example of the activity dependency relationship and input/output property values.

For step-by-step instructions and examples, see the [Quickstart](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-quickstarts) guides.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-34779-9d2602f5-7caf11ea.webp)