---
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

---

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