---
title: "Creates a new channel in a specified Discord guild."
method: POST
path: "/createChannel"
---

# Creates a new channel in a specified Discord guild.

`POST /createChannel`

This function adds a new channel to a specified Discord guild using the provided channel data. It allows for customization of various channel properties such as type, name, topic, and permissions. The function returns a Promise that resolves to the created channel object.

## Request body

- object
  - `body` object — Body of the createChannel sls call
    - `arguments` unknown[], required
      - unknown
    - `auth` object — Authentication object
      - `strategy` 'apikey' — Authentication strategy
      - `variables` unknown[] — Variables for the authentication strategy
        - unknown
    - `packageName` string — @microfox/discord

## Response `200`

Successful response

- object — The created channel object
  - `id` string — The ID of the created channel
  - `type` number — The type of the created channel
  - `name` string — The name of the created channel
  - `topic` string — The topic of the created channel
  - `nsfw` boolean — Whether the created channel is NSFW
  - `parent_id` string — The ID of the parent category for the created channel
  - `permission_overwrites` object[] — Permission overwrites for the created channel
    - `id` string — The role or user ID
    - `type` number — The type (0 for role, 1 for user)
    - `allow` string — Allowed permissions
    - `deny` string — Denied permissions
  - `rate_limit_per_user` number — Slowmode rate limit for the created channel
  - `position` number — Position of the created channel

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `403` — Forbidden - Insufficient permissions to create a channel
- `404` — Not Found - The specified guild does not exist
- `500` — Internal Server Error

## Changes

- **2025-05-29** `2deb154b9766` — 2 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
- **2025-05-28** `d03e8c66c195` — 2 info
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`

[Change history](https://skmtc.dev/microfox-ai/apis/microfox-discord-sdk-api/changes/createChannel/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/microfox-discord-sdk-api.md) · [All operations](https://skmtc.dev/microfox-ai/apis/microfox-discord-sdk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/microfox-discord-sdk-api/revisions/7cb5b64ae924/schema)