teams chat create
Auto-generated reference
This page is generated from checked-in CLI metadata for release v0.9.0. Do not edit it by hand.
Create a new chat
Synopsis
teams chat create [OPTIONS]
Options
| Option | Value | Required | Env | Default | Description |
|---|---|---|---|---|---|
--chat-type | CHAT_TYPE | no | group | Chat type: oneOnOne or group | |
--topic | TOPIC | no | Topic for the chat (group chats only) | ||
--members | MEMBERS | no | Members as comma-separated user IDs; append :guest for guest users (e.g. <id>,<id>:guest). 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 |