---
title: "Create Board"
method: POST
path: "/v1/pinterest/boards"
tags: ["Pinterest"]
---

# Create Board

`POST /v1/pinterest/boards`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/pinterest/boards`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Create a board for a connected Pinterest account.

`SECRET` needs Pinterest's `boards:write_secret` scope. Connections made before
API 1.37 lack it and get `409 scope_missing` until they reconnect.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- BoardCreateRequest: Request schema for creating a Pinterest board.
  - `account_id` string, uuid, required: Pinterest account ID
  - `name` string, required: Board name
  - `description` string, nullable: Board description
  - `privacy` string, nullable: Board privacy (for example PUBLIC, PROTECTED, SECRET)

## Response `201`

Successful Response

- BoardResponse: Response schema for a Pinterest board.
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `privacy` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pinbridge/apis/pinbridge-api.md) · [All operations](https://skmtc.dev/pinbridge/apis/pinbridge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinbridge/apis/pinbridge-api/revisions/b17603589d01?raw)