---
title: "POST /CreateThread"
method: POST
path: "/CreateThread"
tags: ["Thread"]
---

# POST /CreateThread

`POST /CreateThread`

## Headers

- `address` string

## Request body

- object
  - `community_id` string, required
  - `topic_id` integer, required
  - `title` string, required
  - `body` string, required
  - `canvas_signed_data` string
  - `canvas_msg_id` string
  - `kind` 'discussion' | 'link', required
  - `stage` string, required
  - `url` string
  - `read_only` boolean, required
  - `discord_meta` object
    - `user` object, required
      - `id` string, required
      - `username` string, required
    - `channel_id` string, required
    - `message_id` string, required

## Response `200`

Successful response

- object
  - `id` integer
  - `address_id` integer, required
  - `title` string, required
  - `kind` string, required
  - `stage` string
  - `body` string, nullable
  - `url` string, nullable
  - `topic_id` integer, nullable
  - `pinned` boolean, nullable
  - `community_id` string, required
  - `view_count` integer
  - `links` object[], nullable
    - `source` 'snapshot' | 'proposal' | 'thread' | 'web' | 'template', required
    - `identifier` string, required
    - `title` string, nullable
  - `content_url` string, nullable
  - `read_only` boolean, nullable
  - `has_poll` boolean, nullable
  - `canvas_signed_data` string, nullable
  - `canvas_msg_id` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `last_edited` string, date-time, nullable
  - `deleted_at` string, date-time, nullable
  - `last_commented_on` string, date-time, nullable
  - `marked_as_spam_at` string, date-time, nullable
  - `archived_at` string, date-time, nullable
  - `locked_at` string, date-time, nullable
  - `discord_meta` object, nullable
    - `user` object, required
      - `id` string, required
      - `username` string, required
    - `channel_id` string, required
    - `message_id` string, required
  - `reaction_count` integer
  - `reaction_weights_sum` string, nullable
  - `comment_count` integer
  - `activity_rank_date` string, date-time, nullable
  - `created_by` string, nullable
  - `profile_name` string, nullable
  - `search` union, required
    - string
    - object
  - `Address` object, nullable
    - `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
  - `Reaction` object, nullable
    - `id` integer
    - `address_id` integer, required
    - `reaction` 'like', required
    - `thread_id` integer, nullable
    - `comment_id` integer, nullable
    - `proposal_id` number, nullable
    - `calculated_voting_weight` string, nullable
    - `canvas_signed_data` unknown
    - `canvas_msg_id` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `Address` 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
  - `topic` 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
  - `collaborators` object[], nullable
    - `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
  - `reactions` object[], nullable
    - `id` integer
    - `address_id` integer, required
    - `reaction` 'like', required
    - `thread_id` integer, nullable
    - `comment_id` integer, nullable
    - `proposal_id` number, nullable
    - `calculated_voting_weight` string, nullable
    - `canvas_signed_data` unknown
    - `canvas_msg_id` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `Address` 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
  - `ThreadVersionHistories` object[], nullable
    - `id` integer
    - `thread_id` integer, required
    - `address` string, required — Address of the creator of the post or the collaborator
    - `body` string, required
    - `timestamp` string, date-time, required
    - `content_url` string, nullable

## Other responses

- `default` — Error response

---

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