# Microsoft Teams

<!-- Generated by tools/catalogue/generate.py from flow.service.workflow 5.0.0-beta.39. Don't edit by hand. -->

# Microsoft Teams

The Microsoft Teams category has 3 tasks. Each entry shows the task's latest revision, the one the palette adds. See [Reading an entry](https://www.useboomerang.io/docs/flow/main/catalogue/overview#reading-an-entry).

## Add Teams Member

Adds a user to a team as a member or an owner through Microsoft Graph. The app registration needs the TeamMember.ReadWrite.All application permission (TeamMember.ReadWriteNonOwnerRole.All for members only). Guests cannot be added with application permissions. See https://learn.microsoft.com/en-us/graph/api/team-post-members

- **Slug:** `add-teams-member`
- **Type:** `template`
- **Revision:** 1
- **Image:** Default task image.

**Parameters**

| Label | Name | Type | Required | Default | Helper text |
| --- | --- | --- | --- | --- | --- |
| Tenant ID | `tenantId` | Text | Yes | `$(workspace.params.microsoft-tenant-id)` | Defaults to the tenant ID the workspace's Microsoft integration shares; or enter the Directory (tenant) ID of an Entra app registration |
| Client ID | `clientId` | Text | Yes | `$(workspace.params.microsoft-client-id)` | Defaults to the client ID the workspace's Microsoft integration shares; or enter the app registration's Application (client) ID |
| Client Secret | `clientSecret` | Secured | Yes | `$(workspace.params.microsoft-client-secret)` | Defaults to the client secret the workspace's Microsoft integration shares; or enter one of the app registration's. The task gets its own app-only Microsoft Graph token with it |
| Team ID | `teamId` | Text | Yes |  | The team's ID (its Microsoft 365 group ID) |
| User | `user` | Text | Yes |  | The user's user principal name (e.g. jo@contoso.com) or object ID |
| Role | `role` | Select | No | `member` |  |

**Results**

| Name | Description |
| --- | --- |
| `membershipId` | The membership's ID |
| `userId` | The user's object ID |

## Create Teams Channel

Creates a standard or private channel in a team through Microsoft Graph. The app registration needs the Channel.Create application permission. See https://learn.microsoft.com/en-us/graph/api/channel-post

- **Slug:** `create-teams-channel`
- **Type:** `template`
- **Revision:** 1
- **Image:** Default task image.

**Parameters**

| Label | Name | Type | Required | Default | Helper text |
| --- | --- | --- | --- | --- | --- |
| Tenant ID | `tenantId` | Text | Yes | `$(workspace.params.microsoft-tenant-id)` | Defaults to the tenant ID the workspace's Microsoft integration shares; or enter the Directory (tenant) ID of an Entra app registration |
| Client ID | `clientId` | Text | Yes | `$(workspace.params.microsoft-client-id)` | Defaults to the client ID the workspace's Microsoft integration shares; or enter the app registration's Application (client) ID |
| Client Secret | `clientSecret` | Secured | Yes | `$(workspace.params.microsoft-client-secret)` | Defaults to the client secret the workspace's Microsoft integration shares; or enter one of the app registration's. The task gets its own app-only Microsoft Graph token with it |
| Team ID | `teamId` | Text | Yes |  | The team's ID (its Microsoft 365 group ID) |
| Channel Name | `displayName` | Text | Yes |  | Up to 50 characters |
| Description | `description` | Text Area | No |  |  |
| Membership | `membershipType` | Select | No | `standard` | A standard channel is open to the whole team; a private one to its members |
| Owner | `owner` | Text | No |  | Required for a private channel: the owner's user principal name (e.g. jo@contoso.com) or object ID |

**Results**

| Name | Description |
| --- | --- |
| `channelId` | The new channel's ID |
| `channelUrl` | The channel's link in Teams |

## Send Teams Message

Posts a message to a Teams channel or chat through a Teams Workflows webhook (the 'Post to a channel when a webhook request is received' template), as an Adaptive Card. The retired Office 365 connector webhooks are not supported.

- **Slug:** `send-teams-message`
- **Type:** `template`
- **Revision:** 1
- **Image:** Default task image.

**Parameters**

| Label | Name | Type | Required | Default | Helper text |
| --- | --- | --- | --- | --- | --- |
| Webhook URL | `webhookUrl` | Secured | Yes |  | The workflow's HTTP POST URL. It carries the webhook's signature, so it is kept like a password |
| Title | `title` | Text | No |  | Shown large and bold above the message |
| Message | `message` | Text Area | No |  | The message text; Teams renders a subset of Markdown |
| Adaptive Card | `card` | `json` | No |  | A whole Adaptive Card (type AdaptiveCard), or a whole webhook message (type message), sent instead of Title and Message |

No results.