Create a new channel in a Microsoft Teams team

Create a channel using the Microsoft Teams client

This is the fastest path for a single channel in a team you own.

Step 1 — Open the target team

1. Launch the Microsoft Teams desktop or web client (https://teams.microsoft.com).
2. In the left rail, click Teams.
3. Locate the target team (e.g. MSFT). If you cannot see it, click Join or create a team → search.

Step 2 — Add the channel

1. Hover over the team name and click the … (More options) menu.
2. Select Add channel.
3. Fill in the dialog:
   • Channel name: e.g. Computer Use Test
   • Description (optional but recommended): a one-line purpose statement.
   • Privacy: choose Standard, Private, or Shared.
   • Show this channel in everyone's channel list — toggle on if you want it auto-pinned for all members.
4. Click Create.

Step 3 — Configure membership (private / shared only)

1. If you chose Private, Teams prompts you to add specific members — add them now or skip and add later.
2. If you chose Shared, you can invite people from other teams or (if policy permits) other tenants.

Step 4 — Verify

1. The new channel appears under the team in the left rail.
2. Post a test message or upload a file to confirm write access.

Admin tip: If you are not a member of the team, add yourself as an owner first via the Teams admin center at https://admin.teams.microsoft.com → Teams → Manage teams → [team] → Members, then return to the client.

Create a channel with Microsoft Graph

Use Graph when you need to script creation, create many channels at once, or integrate with a provisioning workflow.

Endpoint

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels

Step 1 — Resolve the team ID

If you only know the team's display name, look up the underlying group first:

GET https://graph.microsoft.com/v1.0/groups?$filter=displayName eq 'MSFT' and resourceProvisioningOptions/Any(x:x eq 'Team')

The returned id is the team-id.

Step 2 — Create the channel

Request:

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels
Authorization: Bearer {token}
Content-Type: application/json

{
  "displayName": "Computer Use Test",
  "description": "Sandbox channel for computer-use automation testing.",
  "membershipType": "standard"
}

Valid membershipType values: standard, private, shared.

Step 3 — Example response (201 Created)

{
  "id": "19:abc123...@thread.tacv2",
  "displayName": "Computer Use Test",
  "description": "Sandbox channel for computer-use automation testing.",
  "membershipType": "standard",
  "webUrl": "https://teams.microsoft.com/l/channel/..."
}

Step 4 — Add owners/members (private or shared only)

After creation, post to /teams/{team-id}/channels/{channel-id}/members:

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/members

{
  "@odata.type": "#microsoft.graph.aadUserConversationMember",
  "roles": ["owner"],
  "user@odata.bind": "https://graph.microsoft.com/v1.0/users/{user-id}"
}

Common errors

• 409 Conflict — a channel with that name exists (or was recently deleted and is still reserved).
• 403 Forbidden — token lacks Channel.Create, or caller is not a team owner.
• 400 Bad Request — display name violates naming policy or contains disallowed characters (~#%&*{}+/\:<>?|'").

Create a channel with PowerShell

The MicrosoftTeams module is the simplest option for ad-hoc admin work. For app-only/automation scenarios, use Microsoft.Graph.

Option A — MicrosoftTeams module (interactive)

1. Install and import the module (one-time):

   Install-Module MicrosoftTeams -Scope CurrentUser
   Import-Module MicrosoftTeams

2. Connect as an account that is either a Teams Administrator or an owner of the target team:

   Connect-MicrosoftTeams

3. Resolve the team by display name:

   $team = Get-Team -DisplayName "MSFT"

4. Create the channel:

   New-TeamChannel -GroupId $team.GroupId `
       -DisplayName "Computer Use Test" `
       -Description "Sandbox channel for computer-use automation testing." `
       -MembershipType Standard

Option B — Microsoft.Graph module (scriptable / app-only)

Connect-MgGraph -Scopes "Channel.Create","Team.ReadBasic.All"

$team = Get-MgGroup -Filter "displayName eq 'MSFT'" | Select-Object -First 1

$body = @{
    displayName    = "Computer Use Test"
    description    = "Sandbox channel for computer-use automation testing."
    membershipType = "standard"
}

New-MgTeamChannel -TeamId $team.Id -BodyParameter $body

Verification

Get-TeamChannel -GroupId $team.GroupId | Where-Object DisplayName -eq "Computer Use Test"

The downloadable script below wraps all of this with parameters, lookup, existence checks, and error handling.