---
title: "Add a new board"
method: POST
path: "/v1/boards.json"
tags: ["boards"]
---

# Add a new board

`POST /v1/boards.json`

## Query parameters

- `token` string, required

## Request body

- object
  - `board_visibility` integer
  - `name` string
  - `group_id` integer

## Response `200`

successful operation

- object
  - `id` integer
  - `activities` object
    - `id` string
    - `created` string
    - `modified` string
    - `board_id` integer
    - `list_id` integer
    - `card_id` integer
    - `user_id` integer
    - `foreign_id` integer
    - `type` string
    - `comment` string
    - `revisions` string
    - `root` integer
    - `freshness_ts` string
    - `depth` integer
    - `path` string
    - `materialized_path` string
    - `organization_id` integer
    - `board_name` string
    - `list_name` string
    - `card_name` string
    - `username` string
    - `full_name` string
    - `profile_picture_path` string
    - `initials` string
    - `label_name` string
    - `card_description` string
    - `user_role_id` integer
    - `checklist_item_name` string
    - `checklist_item_parent_name` string
    - `checklist_name` string
    - `organization_name` string
    - `organization_logo_url` string
    - `moved_list_name` string
    - `created_time` string
    - `card_position` string
    - `comment_count` integer
  - `simple_boards` object
    - `id` string
    - `created` string
    - `modified` string
    - `user_id` integer
    - `organization_id` integer
    - `name` string
    - `board_visibility` integer
    - `background_color` string
    - `background_picture_url` string
    - `commenting_permissions` integer
    - `voting_permissions` integer
    - `inivitation_permissions` integer
    - `is_closed` integer
    - `is_allow_organization_members_to_join` integer
    - `boards_user_count` integer
    - `list_count` string
    - `card_count` integer
    - `boards_subscriber_count` integer
    - `background_pattern_url` string
    - `boards_star_count` integer
    - `is_show_image_front_of_card` integer
    - `background_picture_path` string
    - `music_name` string
    - `music_content` string
    - `archived_list_count` integer
    - `archived_card_count` integer
    - `organization_name` string
    - `organization_website_url` string
    - `organization_logo_url` string

---

[API](https://skmtc.net/restyaplatform/apis/restyaboard.md) · [All operations](https://skmtc.net/restyaplatform/apis/restyaboard/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/restyaplatform/restyaboard/revisions/bfc753befdbe/schema)