---
title: "Create Contest"
method: POST
path: "/contests"
tags: ["Threads"]
---

# Create Contest

`POST /contests`

Create a new contest.

Required scopes:
+ **post**

## Request body

- object
  - `post_body` string, required — Content of the new contest.
  - `title` string — Thread title. Can be skipped if **title_en** set.
  - `title_en` string — Thread english title. Can be skipped if **title** set.
  - `contest_type` 'by_finish_date', required — Contest type.
  - `length_value` integer — Giveaway duration value. The maximum duration is 3 days. Required if **contest_type** is **by_finish_date**.
  - `length_option` 'minutes' | 'hours' | 'days' — Giveaway duration type. The maximum duration is 3 days. Required if **contest_type** is **by_finish_date**.
  - `prize_type` 'money' | 'upgrades', required — Prize type.
  - `count_winners` integer — Winner count (prize count). Optional if **prize_type** is **money**.
  - `prize_data_money` number — How much money will each winner receive. Optional if **prize_type** is **money**.
  - `is_money_places` boolean — Enable the distribution of money prizes by places. Optional if **prize_type** is **money**.
  - `prize_data_places` number[] — How much money will receive each place. Required if **is_money_places** is **1**.
  - `prize_data_upgrade` 1 | 6 | 12 | 14 | 17 | 19 | 20 | 21 | 22 — Which upgrade will each winner receive. Required if **prize_type** is **upgrades**.
  - `require_like_count` integer, required — Sympathies for this week.
  - `require_total_like_count` integer, required — Sympathies for all time.
  - `secret_answer` string — Secret answer of your account.
  - `tags` string[] — Thread tags.
  - `reply_group` 0 | 2 | 21 | 22 | 23 | 60 | 351 — Allow to reply only users with chosen or higher group.
  - `comment_ignore_group` boolean — Allow commenting if user can't post in thread.
  - `dont_alert_followers` boolean — Don't alert followers about thread creation.
  - `hide_contacts` boolean — Hide contacts.
  - `allow_ask_hidden_content` boolean — Allow ask hidden content.
  - `schedule_date` string — Date to schedule thread creation (format: `DD-MM-YYYY`).
  - `schedule_time` string — Time to schedule thread creation (format: `HH:MM`).
  - `watch_thread_state` boolean — Watch thread state.
  - `watch_thread` boolean — Receive forum notifications of new posts in this thread.
  - `watch_thread_email` boolean — Receive email notifications of new posts in this thread.

## Response `200`

Successful Response.

- object
  - `thread` RespThreadModel, required
    - `thread_id` integer, required
    - `forum_id` integer, required
    - `thread_title` string, required
    - `thread_view_count` integer, required
    - `creator_user_id` integer, required
    - `creator_username` string, required
    - `creator_username_html` string, required
    - `thread_create_date` integer, required
    - `thread_update_date` integer, required
    - `thread_reply_group_id` integer, required
    - `thread_comment_ignore_group` integer, required
    - `thread_last_bump_date` integer, required
    - `user_is_ignored` boolean, required
    - `thread_post_count` integer, required
    - `thread_is_liked` boolean, required
    - `thread_is_bumped` boolean, required
    - `thread_is_published` boolean, required
    - `thread_is_deleted` boolean, required
    - `thread_is_sticky` boolean, required
    - `thread_is_closed` boolean, required
    - `thread_is_followed` boolean, required
    - `thread_is_starred` boolean, required
    - `thread_hide_contacts` boolean
    - `thread_allow_ask_hidden_content` boolean
    - `first_post` RespPostModel, required
      - `post_id` integer, required
      - `thread_id` integer, required
      - `poster_user_id` integer, required
      - `poster_username` string, required
      - `poster_username_html` string, required
      - `poster_is_banned` integer, required
      - `poster_is_staff` integer, required
      - `post_create_date` integer, required
      - `post_body` string, required
      - `post_body_html` string, required
      - `post_body_plain_text` string, required
      - `signature` string, required
      - `signature_html` string, required
      - `signature_plain_text` string, required
      - `post_like_count` integer, required
      - `delete_info` object
        - `user_id` integer, required
        - `username` string, required
        - `username_html` string, required
        - `date` integer, required
        - `reason` string, required
      - `user_is_ignored` boolean, required
      - `post_is_sticked` boolean, required
      - `post_is_published` boolean, required
      - `post_is_deleted` boolean, required
      - `post_update_date` integer, required
      - `post_is_first_post` boolean, required
      - `post_is_liked` boolean, required
      - `links` object, required
        - `permalink` string, required
        - `detail` string, required
        - `thread` string, required
        - `poster` string, required
        - `likes` string, required
        - `report` string, required
        - `poster_avatar` string, required
      - `permissions` object, required
        - `view` boolean, required
        - `edit` boolean, required
        - `delete` boolean, required
        - `undelete` boolean, required
        - `reply` boolean, required
        - `like` boolean, required
        - `report` boolean, required
        - `stick` boolean, required
        - `unstick` boolean, required
      - `thread_is_deleted` boolean, required
      - `thread_is_closed` boolean, required
      - `thread` RespThreadModel, required — recursive
    - `thread_prefixes` object[], required
      - `prefix_id` integer
      - `prefix_title` string
    - `thread_tags` object, required
    - `links` object, required
      - `permalink` string, required
      - `detail` string, required
      - `followers` string, required
      - `forum` string, required
      - `posts` string, required
      - `first_poster` string, required
      - `first_poster_avatar` string, required
      - `first_post` string, required
      - `last_poster` string
      - `last_post` string
    - `permissions` object, required
      - `view` boolean, required
      - `delete` boolean, required
      - `follow` boolean, required
      - `post` boolean, required
      - `edit` boolean, required
      - `bump` object, required
        - `can` boolean, required
        - `available_count` integer, required
        - `error` string, required
        - `next_available_time` integer, required
    - `node_title` string, required
    - `last_post` RespPostModel
      - `post_id` integer, required
      - `thread_id` integer, required
      - `poster_user_id` integer, required
      - `poster_username` string, required
      - `poster_username_html` string, required
      - `poster_is_banned` integer, required
      - `poster_is_staff` integer, required
      - `post_create_date` integer, required
      - `post_body` string, required
      - `post_body_html` string, required
      - `post_body_plain_text` string, required
      - `signature` string, required
      - `signature_html` string, required
      - `signature_plain_text` string, required
      - `post_like_count` integer, required
      - `delete_info` object
        - `user_id` integer, required
        - `username` string, required
        - `username_html` string, required
        - `date` integer, required
        - `reason` string, required
      - `user_is_ignored` boolean, required
      - `post_is_sticked` boolean, required
      - `post_is_published` boolean, required
      - `post_is_deleted` boolean, required
      - `post_update_date` integer, required
      - `post_is_first_post` boolean, required
      - `post_is_liked` boolean, required
      - `links` object, required
        - `permalink` string, required
        - `detail` string, required
        - `thread` string, required
        - `poster` string, required
        - `likes` string, required
        - `report` string, required
        - `poster_avatar` string, required
      - `permissions` object, required
        - `view` boolean, required
        - `edit` boolean, required
        - `delete` boolean, required
        - `undelete` boolean, required
        - `reply` boolean, required
        - `like` boolean, required
        - `report` boolean, required
        - `stick` boolean, required
        - `unstick` boolean, required
      - `thread_is_deleted` boolean, required
      - `thread_is_closed` boolean, required
      - `thread` RespThreadModel, required — recursive
    - `contest` object
      - `type` string, required
      - `finish_date` integer, required
      - `now_count_members` integer, required
      - `needed_members` integer, required
      - `is_finished` integer, required
      - `count_winners` integer, required
      - `require_like_count` integer, required
      - `require_total_like_count` integer, required
      - `prize_type` string, required
      - `prize_type_phrase` string, required
      - `prize_data` union, required
        - object
        - integer
      - `prize_cost` integer, required
      - `is_money_places` integer, required
      - `chance_to_win` number, required
      - `prize_per_winner` integer, nullable, required
      - `prize_places` object, nullable, required
        - `place` integer, required
        - `amount` integer, required
      - `already_participate` boolean, required
      - `permissions` object, required
        - `can_finish` boolean, required
        - `can_participate` boolean, required
        - `can_view_user_list` boolean, required
  - `system_info` RespSystemInfo, required
    - `visitor_id` integer, required
    - `time` integer, required
    - `log_id` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Error Response.

---

[API](https://skmtc.net/lolz/apis/lolzteam-public-api-forum.md) · [All operations](https://skmtc.net/lolz/apis/lolzteam-public-api-forum/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lolz/lolzteam-public-api-forum/versions/3efcdbc40994/schema)