---
title: "Changes to Create board"
method: POST
path: "/boards"
---

# Changes to Create board

`POST /boards`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 29 revisions.

- **2025-10-16** (v5) `14c297539b64` — 7 breaking, 10 warning, 10 info
- **2025-07-16** (v5) `43134ca41f18` — 2 info
- **2025-04-04** (v5) `10f9eba4ad97` — 1 info
- **2023-05-12** (v5) `689b4b267639` — 7 info
- **2021-11-05** (v5) `8583f6373a80` — 1 breaking, 1 info

## Changes

- **2025-10-16** (v5) `14c297539b64` — 7 breaking, 10 warning, 10 info
  - added `#/components/schemas/BoardPrivacy` to the `privacy` request property `allOf` list
  - removed the enum value `PROTECTED` of the request property `privacy`
  - removed the enum value `PUBLIC` of the request property `privacy`
  - removed the enum value `SECRET` of the request property `privacy`
  - the `privacy` request property type/format changed from `string`/`` to ``/``
  - the `privacy` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - removed the required property `name` from the response with the `201` status
  - removed the optional property `board_pins_modified_at` from the response with the `201` status
  - removed the optional property `collaborator_count` from the response with the `201` status
  - removed the optional property `created_at` from the response with the `201` status
  - removed the optional property `description` from the response with the `201` status
  - removed the optional property `follower_count` from the response with the `201` status
  - removed the optional property `id` from the response with the `201` status
  - removed the optional property `is_ads_only` from the response with the `201` status
  - removed the optional property `media` from the response with the `201` status
  - removed the optional property `owner` from the response with the `201` status
  - removed the optional property `pin_count` from the response with the `201` status
  - added `#/components/schemas/BoardBase` to the response body `allOf` list for the response status `201`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added `#/components/schemas/BoardPrivacy` to the `privacy` response property `allOf` list for the response status `201`
  - removed the `PROTECTED` enum value from the `privacy` response property for the response status `201`
  - removed the `PUBLIC` enum value from the `privacy` response property for the response status `201`
  - removed the `SECRET` enum value from the `privacy` response property for the response status `201`
  - added the success response with the status `200`
- **2025-07-16** (v5) `43134ca41f18` — 2 info
  - added the new optional request property `is_ads_only`
  - added the optional property `is_ads_only` to the response with the `201` status
- **2025-04-04** (v5) `10f9eba4ad97` — 1 info
  - the endpoint scheme security `client_credentials` was added to the API
- **2023-05-12** (v5) `689b4b267639` — 7 info
  - added the new optional `query` request parameter `ad_account_id`
  - added the optional property `board_pins_modified_at` to the response with the `201` status
  - added the optional property `collaborator_count` to the response with the `201` status
  - added the optional property `created_at` to the response with the `201` status
  - added the optional property `follower_count` to the response with the `201` status
  - added the optional property `media` to the response with the `201` status
  - added the optional property `pin_count` to the response with the `201` status
- **2021-11-05** (v5) `8583f6373a80` — 1 breaking, 1 info
  - the `owner` response's property type/format changed from ``/`` to `object`/`` for status `201`
  - added the non-success response with the status `400`

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/boards/post.md) · [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/boards/post)