---
title: "Create Space Group"
method: POST
path: "/communities/{community_id}/space_groups"
tags: ["Communities::SpaceGroup"]
---

# Create Space Group

`POST /communities/{community_id}/space_groups`

Create a space group within a community

## Path parameters

- `community_id` integer, required

## Request body

- object
  - `communities_space_group` CommunitiesSpaceGroupParameters — Communities::SpaceGroup
    - `name` string, required — Name
    - `description` string, nullable — Description
    - `access` integer, nullable — Access level (0 = open, 1 = private, 2 = secret)
    - `group_type` integer, nullable — Group type (integer enum)
    - `current_path` string, nullable — Current Path
    - `emoji` string, nullable — Emoji icon for the group
    - `card_image_id` integer, nullable — Card Image ID
    - `auto_add_to_spaces` boolean, nullable — Automatically add members to new Topics within this Group
    - `approval_terms` string, nullable — Approval Terms
    - `require_post_approvals` boolean, nullable — Require approvals for posts in this Group?
    - `require_post_approvals_override` boolean, nullable — Override community-level post approval setting for this group
    - `require_comment_approvals` boolean, nullable — Require approvals for comments in this Group?
    - `require_comment_approvals_override` boolean, nullable — Override community-level comment approval setting for this group
    - `is_hidden` boolean, nullable — Only show joined Topics
    - `is_hidden_from_non_members` boolean, nullable — Hide from non-members
    - `always_on` boolean, nullable — Always On
    - `upgrade_url` string, nullable — Upgrade URL
    - `sort_order` integer, nullable — Sort order within the community

## Response `201`

Created

- CommunitiesSpaceGroupAttributes — Communities::SpaceGroup
  - `id` integer — Group ID
  - `public_id` string, nullable — Group public ID
  - `community_id` integer — Community ID the space group belongs to
  - `workspace_id` integer — Workspace ID the space group belongs to
  - `name` string, nullable — Name
  - `description` string, nullable — Description
  - `access` 'is_open' | 'is_private' | 'is_secret' — Access level
  - `group_type` 'standard' | 'course' — Group type
  - `current_path` string, nullable — Current Path
  - `emoji` string, nullable — Emoji icon for the group
  - `card_image_id` integer, nullable — Card Image ID
  - `auto_add_to_spaces` boolean — Automatically add members to new Topics within this Group
  - `approval_terms` string, nullable — Approval Terms — if present, these terms are used to AI moderate posts and comments automatically
  - `require_post_approvals` boolean, nullable — Require approvals for posts in this Group?
  - `require_post_approvals_override` boolean, nullable — Whether the group-level post approval setting overrides the community-level setting
  - `require_comment_approvals` boolean, nullable — Require approvals for comments in this Group?
  - `require_comment_approvals_override` boolean, nullable — Whether the group-level comment approval setting overrides the community-level setting
  - `is_hidden` boolean — Only show joined Topics — when enabled customers only see Topics in the sidebar they have joined
  - `is_hidden_from_non_members` boolean — Hide from non-members — when enabled the group is not visible unless the customer belongs to one of its Topics
  - `always_on` boolean, nullable — Always On
  - `upgrade_url` string, nullable — Upgrade URL — directs non-customers to an action page to gain access to this group
  - `sort_order` integer, nullable — Sort order within the community
  - `created_at` string, date-time, nullable — Created at
  - `updated_at` string, date-time, nullable — Updated at

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/myclickfunnels/apis/clickfunnels-api.md) · [All operations](https://skmtc.net/myclickfunnels/apis/clickfunnels-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myclickfunnels/clickfunnels-api/versions/ae6313eaa176/schema)