capabilities.work

Provision a Teams Channel and Announce It

A 5-step recipe with Microsoft Office. We can help you get access.

Recipe · 5 steps

Provision a Teams Channel and Announce It

with Microsoft Office

Idempotently create a Teams channel and post its first message.

  1. List the teams the signed-in user belongs to, confirming the caller has standing in the tenant before attempting any team-scoped write.
  2. Read the target team by id to confirm it resolves and to capture its display name for the announcement copy.
  3. List the team's existing channels so provisioning is idempotent: an existing channel of the same name is reused rather than duplicated.
  4. Create the channel in the team, applying the requested membership model. Graph answers with the created channel and its id.
  5. Post the kickoff message to the channel so members arriving from the Teams notification find context rather than an empty conversation.
What you'll need to have ready
  • teamId: The id of the team to provision the channel in.
  • channelDisplayName: Display name of the channel to create if it does not exist.
  • channelDescription: Description applied to a newly created channel.
  • membershipType: Channel membership model.
  • kickoffMessage: HTML content of the first message posted to the channel.
For your developer

Arazzo workflow microsoft-office:teams-channel-provisioning, 5 operations: listMyJoinedTeams → getTeam → listTeamChannels → createTeamChannel → sendChannelMessage. Specs on APIs.io.

More recipes with Microsoft Office

Discover and Download a OneDrive FileAnnounce a New OneDrive File in a Teams ChannelUpdate a OneDrive File and Verify the WriteInventory Mail Folders and Export MessagesEscalate an Inbox Message to a Teams ChannelTriage Inbox Messages and RespondBuild a Teams Channel Message Digest