---
title: "POST /api/guilds/"
method: POST
path: "/api/guilds/"
tags: ["api"]
---

# POST /api/guilds/

`POST /api/guilds/`

## Request body

- GuildCreateSchema
  - `name` string
  - `region` string
  - `icon` string, nullable
  - `channels` ChannelCreateSchema[]
    - `name` string
    - `id` string
    - `type` 0 | 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 2 | 255 | 3 | 4 | 5 | 6 | 7 | 8 | 9
    - `flags` integer
    - `icon` string, nullable
    - `parent_id` string
    - `default_auto_archive_duration` integer
    - `permission_overwrites` object[]
      - `id` string, required
      - `type` 0 | 1 | 2, required
      - `allow` string, required
      - `deny` string, required
    - `video_quality_mode` integer
    - `bitrate` integer
    - `user_limit` integer
    - `nsfw` boolean
    - `rate_limit_per_user` integer
    - `topic` string
    - `default_thread_rate_limit_per_user` integer
    - `applied_tags` string[]
    - `position` integer
    - `invitable` boolean
    - `rtc_region` string
    - `default_reaction_emoji` string, nullable
    - `auto_archive_duration` integer
    - `archived` boolean
    - `locked` boolean
  - `system_channel_id` string
  - `rules_channel_id` string
  - `guild_template_code` string
  - `staff_only` boolean

## Response `201`

- GuildCreateResponse
  - `id` string, required
  - `name` string, required
  - `large` boolean
  - `max_members` integer
  - `max_presences` integer
  - `max_video_channel_users` integer
  - `member_count` integer
  - `presence_count` integer
  - `mfa_level` integer
  - `owner_id` string
  - `premium_subscription_count` integer
  - `premium_tier` integer
  - `welcome_screen` GuildWelcomeScreen, required
    - `enabled` boolean, required
    - `description` string, required
    - `welcome_channels` object[], required
      - `description` string, required
      - `emoji_id` string
      - `emoji_name` string
      - `channel_id` string, required
  - `widget_channel_id` string
  - `widget_enabled` boolean, required
  - `nsfw_level` integer
  - `nsfw` boolean, required
  - `parent` string
  - `region` string
  - `icon` string, nullable
  - `system_channel_id` string
  - `rules_channel_id` string
  - `guild_template_code` string
  - `staff_only` boolean
  - `banner` string, nullable
  - `splash` string, nullable
  - `description` string
  - `features` string[]
  - `verification_level` integer
  - `default_message_notifications` integer
  - `system_channel_flags` integer
  - `explicit_content_filter` integer
  - `public_updates_channel_id` string
  - `afk_timeout` integer
  - `afk_channel_id` string
  - `preferred_locale` string
  - `premium_progress_bar_enabled` boolean
  - `discovery_splash` string
  - `safety_alerts_channel_id` string, nullable

## Other responses

- `400`
- `403`

---

[API](https://skmtc.net/spacebarchat/apis/spacebar-server.md) · [All operations](https://skmtc.net/spacebarchat/apis/spacebar-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spacebarchat/spacebar-server/versions/034b4e879932/schema)