---
title: "Create a channel"
method: POST
path: "/conversations"
tags: ["Conversations"]
---

# Create a channel

`POST /conversations`

Creates a channel in the authenticated workspace. Same operation as the MCP create_conversation tool: channels are public unless access_control_type is "private", the caller always joins, and a name already used by an active channel returns 409 channel_name_conflict.

## Request body

- CreateConversationBody — Channel creation request. Same operation as the MCP create_conversation tool.
  - `access_control_type` 'public' | 'private' — Channel visibility. Defaults to "public".
  - `member_ids` string[] — Workspace member ids to include as initial channel members. The caller is always included.
  - `name` string, required — The channel name.

## Response `200`

Created channel.

- CreateConversationResponse — Created channel response.
  - `data` CreateConversationResult, required — Created channel projection.
    - `access_control_type` 'public' | 'private', required — Channel visibility.
    - `conversation_id` string, required — Conversation identifier.
    - `member_ids` string[], required — Workspace member ids of the initial channel members, including the caller.
    - `name` string, nullable, required — Channel name.

## Other responses

- `400` — Bad request.
- `401` — Missing or invalid API key.
- `403` — Forbidden.
- `404` — Not found.
- `409` — Conflict.
- `429` — Rate limit or quota exceeded.
- `500` — Internal server error.

---

[API](https://skmtc.net/ando/apis/ando-public-api.md) · [All operations](https://skmtc.net/ando/apis/ando-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ando/ando-public-api/revisions/0a94056fba48/schema)