---
title: "POST /CreateGroup"
method: POST
path: "/CreateGroup"
tags: ["Community"]
---

# POST /CreateGroup

`POST /CreateGroup`

## Headers

- `address` string

## Request body

- object
  - `community_id` string, required
  - `metadata` object, required
    - `name` string, required
    - `description` string, required
    - `required_requirements` integer, nullable
    - `membership_ttl` integer
  - `requirements` union[]
    - union
      - object
        - `rule` 'threshold', required
        - `data` object, required
          - `threshold` string, required
          - `source` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - object
        - `rule` 'allow', required
        - `data` object, required
          - `allow` string[], required
  - `topics` object[]
    - `id` integer, required
    - `permissions` string[], required

## Response `200`

Successful response

- object
  - `id` string
  - `name` string
  - `chain_node_id` integer, nullable
  - `default_symbol` string
  - `network` string
  - `base` 'cosmos' | 'substrate' | 'ethereum' | 'near' | 'solana'
  - `icon_url` string, nullable
  - `active` boolean
  - `type` 'chain' | 'dao' | 'token' | 'offchain'
  - `description` string, nullable
  - `social_links` string[]
  - `ss58_prefix` integer, nullable
  - `stages_enabled` boolean
  - `custom_stages` string[]
  - `custom_domain` string, nullable
  - `block_explorer_ids` string, nullable
  - `collapsed_on_homepage` boolean
  - `default_summary_view` boolean, nullable
  - `default_page` 'default_all_discussions_view' | 'default_summary_view' | 'homepage', nullable
  - `has_homepage` 'true' | 'false', nullable
  - `terms` union
    - string
    - ''
    - string, uri
  - `admin_only_polling` boolean, nullable
  - `bech32_prefix` string, nullable
  - `hide_projects` boolean, nullable
  - `token_name` string, nullable
  - `ce_verbose` boolean, nullable
  - `discord_config_id` integer, nullable
  - `category` unknown
  - `discord_bot_webhooks_enabled` boolean, nullable
  - `directory_page_enabled` boolean
  - `directory_page_chain_node_id` integer, nullable
  - `namespace` string, nullable
  - `namespace_address` string, nullable
  - `redirect` string, nullable
  - `snapshot_spaces` string[]
  - `include_in_digest_email` boolean, nullable
  - `profile_count` integer, nullable
  - `lifetime_thread_count` integer
  - `banner_text` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `Addresses` object[]
    - `id` integer
    - `address` string, required
    - `community_id` string, required
    - `user_id` integer, nullable
    - `verification_token` string
    - `verification_token_expires` string, date-time, nullable
    - `verified` string, date-time, nullable
    - `last_active` string, date-time, nullable
    - `ghost_address` boolean
    - `wallet_id` 'magic' | 'polkadot' | 'metamask' | 'walletconnect' | 'keplr-ethereum' | 'keplr' | 'leap' | 'near' | 'terrastation' | 'terra-walletconnect' | 'cosm-metamask' | 'phantom' | 'coinbase', nullable
    - `block_info` string, nullable
    - `is_user_default` boolean
    - `role` 'admin' | 'moderator' | 'member'
    - `is_banned` boolean
    - `hex` string, nullable
    - `User` object
      - `id` integer
      - `email` string, email, nullable
      - `isAdmin` boolean, nullable
      - `disableRichText` boolean
      - `emailVerified` boolean, nullable
      - `selected_community_id` string, nullable
      - `emailNotificationInterval` 'weekly' | 'never'
      - `promotional_emails_enabled` boolean, nullable
      - `is_welcome_onboard_flow_complete` boolean
      - `profile` object, required
        - `name` string, nullable
        - `email` string, nullable
        - `website` string, nullable
        - `bio` string, nullable
        - `avatar_url` string, nullable
        - `slug` string, nullable
        - `socials` string[], nullable
        - `background_image` object, nullable
          - `url` string, nullable
          - `imageBehavior` string, nullable
      - `xp_points` integer, nullable
      - `ProfileTags` object[]
        - `user_id` number, required
        - `tag_id` number, required
        - `created_at` string, date-time
        - `updated_at` string, date-time
      - `ApiKey` object
        - `user_id` integer
        - `hashed_api_key` string, required
        - `salt` string, required
        - `created_at` string, date-time
        - `updated_at` string, date-time
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `CommunityStakes` object[], nullable
    - `id` integer
    - `community_id` string, required
    - `stake_id` integer
    - `stake_token` string
    - `vote_weight` integer
    - `stake_enabled` boolean
    - `StakeTransactions` object[], nullable
      - `transaction_hash` string, required
      - `community_id` string, required
      - `stake_id` integer
      - `address` string, required
      - `stake_amount` integer, required
      - `stake_price` string
      - `stake_direction` 'buy' | 'sell', required
      - `timestamp` integer, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `CommunityTags` object[], nullable
    - `community_id` string, required
    - `tag_id` integer, required
    - `Tag` object, nullable
      - `id` integer
      - `name` string, required
  - `ChainNode` object, nullable
    - `id` integer, nullable
    - `url` string, nullable
    - `eth_chain_id` integer, nullable
    - `alt_wallet_url` string, nullable
    - `private_url` string, nullable
    - `balance_type` 'terra' | 'ethereum' | 'solana' | 'cosmos' | 'near' | 'substrate', nullable
    - `name` string, nullable
    - `description` string, nullable
    - `ss58` integer, nullable
    - `bech32` string, nullable
    - `slip44` integer, nullable
    - `cosmos_chain_id` string, nullable
    - `cosmos_gov_version` 'v1' | 'v1beta1govgen' | 'v1beta1' | 'v1beta1-attempt-failed' | 'v1-attempt-failed', nullable
    - `health` 'failed' | 'healthy', nullable
    - `contracts` object[], nullable
      - `id` integer, required
      - `address` string, required
      - `chain_node_id` integer, required
      - `abi_id` integer, nullable
      - `decimals` integer
      - `token_name` string
      - `symbol` string
      - `type` string, required
      - `is_factory` boolean
      - `nickname` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `block_explorer` string, nullable
    - `max_ce_block_range` number, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `topics` object[]
    - `id` integer
    - `name` string
    - `community_id` string, required
    - `description` string
    - `telegram` string, nullable
    - `featured_in_sidebar` boolean
    - `featured_in_new_post` boolean
    - `default_offchain_template` string, nullable
    - `order` integer, nullable
    - `channel_id` string, nullable
    - `group_ids` integer[]
    - `default_offchain_template_backup` string, nullable
    - `weighted_voting` 'stake' | 'erc20', nullable
    - `token_address` string, nullable — token address, used for ERC20 topics
    - `token_symbol` string, nullable — token symbol, used for ERC20 topics
    - `vote_weight_multiplier` number, nullable — vote weight multiplier, used for ERC20 topics
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` string, date-time, nullable
    - `contest_topics` object[], nullable
      - `contest_address` string, required
      - `topic_id` integer, required
      - `created_at` string, date-time, required
  - `groups` object[]
    - `id` integer
    - `community_id` string, required
    - `metadata` object, required
      - `name` string, required
      - `description` string, required
      - `required_requirements` integer, nullable
      - `membership_ttl` number, nullable
    - `requirements` union[], required
      - union
        - object
          - `rule` 'threshold', required
          - `data` object, required
            - `threshold` string, required
            - `source` union, required
              - …
        - object
          - `rule` 'allow', required
          - `data` object, required
            - `allow` string[], required
    - `is_system_managed` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `contest_managers` object[]
    - `contest_address` string, required — On-Chain contest manager address
    - `community_id` string, required
    - `name` string, required
    - `image_url` string, nullable
    - `funding_token_address` string, nullable — Provided by admin on creation when stake funds are not used
    - `prize_percentage` integer, nullable — Percentage of pool used for prizes in recurring contests
    - `payout_structure` integer[], required — Sorted array of percentages for prize, from first to last
    - `interval` integer, required — Recurring contest interval, 0 when one-off
    - `ticker` string
    - `decimals` integer
    - `created_at` string, date-time, required
    - `cancelled` boolean, nullable — Flags when contest policy is cancelled by admin
    - `ended` boolean, nullable — Flags when the one-off contest has ended and rollover was completed
    - `topics` object[], nullable
      - `id` integer
      - `name` string
      - `community_id` string, required
      - `description` string
      - `telegram` string, nullable
      - `featured_in_sidebar` boolean
      - `featured_in_new_post` boolean
      - `default_offchain_template` string, nullable
      - `order` integer, nullable
      - `channel_id` string, nullable
      - `group_ids` integer[]
      - `default_offchain_template_backup` string, nullable
      - `weighted_voting` 'stake' | 'erc20', nullable
      - `token_address` string, nullable — token address, used for ERC20 topics
      - `token_symbol` string, nullable — token symbol, used for ERC20 topics
      - `vote_weight_multiplier` number, nullable — vote weight multiplier, used for ERC20 topics
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `deleted_at` string, date-time, nullable
      - `contest_topics` object[], nullable
        - `contest_address` string, required
        - `topic_id` integer, required
        - `created_at` string, date-time, required
    - `contests` object[], nullable
      - `contest_address` string, required — On-Chain contest manager address
      - `contest_id` integer, required — On-Chain contest id, 0 when one-off
      - `start_time` string, date-time, required
      - `end_time` string, date-time, required
      - `score_updated_at` string, date-time, nullable
      - `score` object[], nullable — Contest score, sorted from first to last
        - `creator_address` string, required
        - `content_id` string, required
        - `votes` integer, required
        - `prize` string, required
        - `tickerPrize` number
      - `actions` object[], nullable
        - `contest_address` string, required — On-Chain contest manager address
        - `contest_id` integer, required — On-Chain contest id, 0 when one-off
        - `content_id` integer, required — On-Chain content id, 0 when adding
        - `actor_address` string, required
        - `action` 'added' | 'upvoted', required — Type of content action
        - `content_url` string, nullable — Content url
        - `thread_id` integer, nullable — Thread id mapped from content url
        - `thread_title` string, nullable
        - `voting_power` integer, required — Voting power of address when action was recorded
        - `created_at` string, date-time, required — Date-time when action was recorded
    - `farcaster_frame_url` string, nullable
    - `farcaster_frame_hashes` string[], nullable
    - `neynar_webhook_id` string, nullable

## Other responses

- `default` — Error response

---

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