---
title: "Create a Pinterest board"
method: POST
path: "/api/social-accounts/pinterest/boards"
tags: ["Accounts"]
---

# Create a Pinterest board

`POST /api/social-accounts/pinterest/boards`

## Request

- Base URL: `https://api.dunsocial.com`
- URL: `https://api.dunsocial.com/api/social-accounts/pinterest/boards`
- Auth: HTTP bearer

Creates a real board on Pinterest. Default privacy is PUBLIC so the board appears on the profile.

## Headers

- `X-Workspace-Id` string, required

## Request body

- CreatePinterestBoardRequest
  - `name` string, required
  - `privacy` 'PUBLIC' | 'SECRET'
  - `socialAccountId` string

## Response `200`

Created board

- object
  - `success` true, required
  - `data` CreatePinterestBoardResponse
    - `board` PinterestBoard, required
      - `id` string, required
      - `name` string, required
      - `url` string
      - `privacy` 'PUBLIC' | 'SECRET'
    - `socialAccountId` string

## Other responses

- `401`: Missing or invalid bearer token
- `402`: Workspace is not on a paid plan
- `403`: Wrong workspace, missing scope, or role
- `404`: Resource not found

---

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