create_channel
Create a new public or private channel in a specified Mattermost team. The authenticated user is set as the channel admin.
Instructions
Create a new channel in a team.
Creates either a public (O) or private (P) channel. The authenticated user becomes the channel admin. Each call creates a new channel; use get_channel_by_name to check if it exists.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Channel name (lowercase, no spaces) | |
| header | No | Channel header | |
| purpose | No | Channel purpose | |
| team_id | Yes | 26-character team identifier (e.g., 'o5w8h47pdfbzjc4d8w7dhnhren') | |
| channel_type | No | Channel type: O=public, P=private, D=direct message, G=group message | O |
| display_name | Yes | Human-readable channel name |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Unique channel identifier | |
| name | Yes | URL-friendly channel name | |
| type | Yes | Channel type: O=public, P=private, D=direct, G=group | |
| header | Yes | Channel header text | |
| purpose | Yes | Channel purpose description | |
| team_id | Yes | Team this channel belongs to | |
| create_at | Yes | Creation timestamp in milliseconds | |
| delete_at | Yes | Deletion timestamp (0 if not deleted) | |
| update_at | Yes | Last update timestamp in milliseconds | |
| creator_id | Yes | User ID who created the channel | |
| display_name | Yes | Human-readable channel name | |
| last_post_at | Yes | Timestamp of last post | |
| total_msg_count | Yes | Total message count |