teams chat create
Auto-generated reference
This page is generated from checked-in CLI metadata for release v0.3.0. Do not edit it by hand.
Create a one-on-one or group chat. Members default to the owner role; append :guest for Microsoft Entra guest users.
Synopsis
teams chat create [--chat-type group|oneOnOne] [--topic TOPIC] [--members USER_ID[:owner|guest],USER_ID[:owner|guest]]
Options
| Option | Value | Required | Env | Default | Description |
|---|---|---|---|---|---|
--type, --chat-type | TYPE | no | group | Chat type: oneOnOne or group | |
--topic | TOPIC | no | Topic for group chats | ||
--members | IDS | no | Comma-separated user IDs; append :guest for guest users. Default role is owner |
Examples
Create a one-on-one chat
teams chat create --type oneOnOne --members "$USER_ID,$COLLEAGUE_ID" --output json
Create a chat with a guest user
teams chat create --type oneOnOne --members "$USER_ID,$GUEST_USER_ID:guest" --output json
Exit Codes
| Code | Meaning |
|---|---|
| 0 | success |
| 2 | invalid input |
| 3 | authentication error |
| 4 | permission denied |
| 6 | rate limited |