# Create channel > The **Create Channel** activity calls the Microsoft Graph [CreateChannel](https://docs.microsoft.com/en-us/graph/api/channel-post?view=graph-rest-beta&tabs=http) API to create a new channel (**Name**) in your specified team (**TeamId**). ## Overview The **Create Channel** activity calls the Microsoft Graph [CreateChannel](https://docs.microsoft.com/en-us/graph/api/channel-post?view=graph-rest-beta&tabs=http) API to create a new channel (**Name**) in your specified team (**TeamId**). After creating your new channel, the activity outputs its properties in a `Channel` object that you can use as input variables in subsequent activities (for example, `Channel.Id` in [Get Messages](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-get-messages#get-messages), [Send Message](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-send-message#send-message), 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 an activity or run an external process that outputs a `Team.Id` value (for example, [Get Teams](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-get-teams#get-teams)). 4. Add the **Create Channel** activity inside the **Microsoft Teams Scope** activity. 5. Enter values for the [Input](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-create-channel#input) properties. 6. Create and enter a `Channel` variable for your [Output](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-create-channel#output) property. 7. Run the activity. * Your input property values are sent to the [CreateChannel](https://docs.microsoft.com/en-us/graph/api/channel-post?view=graph-rest-beta&tabs=http) API. * The API returns the `Channel` value to your output property variable. ![docs image](https://dev-assets.cms.uipath.com/assets/images/marketplace/marketplace-docs-image-34287-3440466a-33f0eefe.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-33395-c20f722f-b5d24cb5.webp) ### Common #### DisplayName The display name of the activity. | Attributes | Details | | --- | --- | | **Type** | `String` | | **Required** | Yes | | **Default value** | *Create Channel* | | **Allowed values** | Enter a `String` or `String` variable. | | **Notes** | N/A | ### Input #### Name The display name for your new channel. | 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. | #### TeamId The Id of the `Team` object that you want to create the channel in. | Attributes | Details | | --- | --- | | **Type** | `String` | | **Required** | Yes | | **Default value** | Empty | | **Allowed values** | Enter a `String` or `String` variable. | | **Notes** | To get the `Team.Id` value, use an external process or activity that includes the `Team.Id` value in its output (for example, [Get Teams](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-get-teams#get-teams) or external API call) | ### Misc #### Private If selected, the values of variables and arguments are no longer logged at Verbose level. | Attributes | Details | | --- | --- | | **Type** | Checkbox | | **Required** | No | | **Default value** | Not Selected | | **Allowed values** | Selected or Not Selected | | **Notes** | N/A | ### Options #### Description An optional description for the channel. | Attributes | Details | | --- | --- | | **Type** | `String` | | **Required** | No | | **Default value** | Empty | | **Allowed values** | Enter a `String` or `String` variable. | | **Notes** | N/A | ### Output #### Channel The `Channel` object that represents your created channel. | Attributes | Details | | --- | --- | | **Type** | `Channel` | | **Required** | No (required if you plan to use the output data in subsequent activities) | | **Default value** | Empty | | **Allowed values** | Enter a `Channel` variable. | | **Notes** | The variable you create for this property can be used as an input variable in subsequent activities (for example, `Channel.Id` in [Get Messages](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-get-messages#get-messages), [Send Message](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-teams-send-message#send-message), and so on). The `Channel` object includes multiple [properties](https://docs.microsoft.com/en-us/graph/api/resources/channel?view=graph-rest-beta#properties) and [relationships](https://docs.microsoft.com/en-us/graph/api/resources/channel?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 `Channel` object (for example, `Visibility`). 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-36564-66d602d1-4568a7e1.webp)