# Create team

> The **Create Team** activity calls the Microsoft Graph [CreateTeam](https://docs.microsoft.com/en-us/graph/api/team-post?view=graph-rest-beta) API to create a new team (**Name**) according to your specified structure (**Template**) and visibility type (**Visibility** - *Public* or *Private*).

## Overview

The **Create Team** activity calls the Microsoft Graph [CreateTeam](https://docs.microsoft.com/en-us/graph/api/team-post?view=graph-rest-beta) API to create a new team (**Name**) according to your specified structure (**Template**) and visibility type (**Visibility** - *Public* or *Private*).

After creating your new team, the activity outputs its properties in a `Team` object that you can use as input variables in subsequent activities (for example, `Team.Id` in [Get Channels](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-get-channels#get-channels), [Update Channel](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-update-channel#update-channel), and so on).

## How it works

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

1. Complete the [Setup](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-setup#setup) steps.
2. Add the [Microsoft Teams Scope](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-scope#microsoft-teams-scope) activity to your project.
3. Add the **Create Team** activity inside the **Microsoft Teams Scope** activity.
4. Enter values for the [Input](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-create-team#input) properties.
5. Create and enter a `Team` variable for your [Output](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-create-team#output) property.
6. Run the activity.
   * Your input property values are sent to the [CreateTeam](https://docs.microsoft.com/en-us/graph/api/team-post?view=graph-rest-beta) API.
   * The API returns the `Team` value to your output property variable.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/marketplace/marketplace-docs-image-34659-3023a2c8-ee8ac3b7.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/marketplace/marketplace-docs-image-34179-ce0fa1d3-8a97f197.webp)

### Common

#### DisplayName

The display name of the activity.

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

### Input

#### Name

The display name for your new team.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | This value is displayed in the Microsoft Teams app. |

### Options

#### Description

An optional description for the team.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | No |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | N/A |

#### Template

The [template](https://docs.microsoft.com/en-us/MicrosoftTeams/get-started-with-teams-templates) that you want to use to create your team.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | *"standard"* (not shown) |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | To create a standard template, leave the property empty.  To create a different template type, enter any [base template type](https://docs.microsoft.com/en-us/MicrosoftTeams/get-started-with-teams-templates#what-are-base-template-types) `String` value. When entering your value, use the template name as it is shown in the **baseTemplateId** column in the link provided (e.g., *"educationStaff"*, *"retailStore"*, etc.). |

#### Visibility

The visibility that you want to assign to your team.

| Attributes | Details |
| --- | --- |
| **Type** | `TeamVisibilityType` |
| **Required** | No |
| **Default value** | *TeamVisibilityType.Private* (not shown) |
| **Allowed values** | Enter a `TeamVisibilityType` or `TeamVisibilityType` variable (see notes below). |
| **Notes** | Enter one of the following two accepted values:  *TeamVisibilityType.Private* - Anyone can see the team but only the owner can add a user to the team.  *TeamVisibilityType.Public* - Anyone can join the team. |

### 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 (for example, `Team.Id` in [Get Channels](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-get-channels#get-channels), [Update Channel](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-update-channel#update-channel), and so on).  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 (for example, `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/marketplace/automation-cloud/latest/user-guide/microsoft-teams-quickstarts) guides.

![docs image](https://dev-assets.cms.uipath.com/assets/images/marketplace/marketplace-docs-image-33899-a920e257-7d486af1.webp)