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

# POST /CreateCommunity

`POST /CreateCommunity`

## Headers

- `address` string

## Request body

- object
  - `id` string, required
  - `name` string, required
  - `chain_node_id` integer, required
  - `description` string
  - `icon_url` string, uri
  - `social_links` string[]
  - `tags` string[]
  - `directory_page_enabled` boolean
  - `type` 'chain' | 'dao' | 'token' | 'offchain'
  - `base` 'cosmos' | 'substrate' | 'ethereum' | 'near' | 'solana', required
  - `token_name` string
  - `default_symbol` string, required
  - `website` string, uri
  - `github` string, uri
  - `telegram` string, uri
  - `element` string, uri
  - `discord` string, uri

## Response `200`

Successful response

- object
  - `community` object, required
    - `id` string, required
    - `name` string, required
    - `chain_node_id` integer, nullable
    - `default_symbol` string
    - `network` string
    - `base` 'cosmos' | 'substrate' | 'ethereum' | 'near' | 'solana', required
    - `icon_url` string, nullable
    - `active` boolean, required
    - `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
              - …
          - object
            - `rule` 'allow', required
            - `data` object, 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
  - `admin_address` string

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