Pinterest

Create Pinterest Board

POST
/v1/accounts/{id}/boards

Authorization

Bearer
headerAuthorizationBearer <op_>

Workspace API key, sent as Authorization: Bearer op_... Keys are created in the dashboard.

Path Parameters

id*string
Length1 <= length

Header Parameters

Idempotency-Key?string

A unique key, such as a UUID, that makes retrying this request safe. A repeat with the same key and body within 24 hours returns the first response instead of acting again. A 429 or 5xx response is not kept, so a retry with the same key runs again.

Length1 <= length <= 255

Request Body

application/json
  1. body
name*string

Board name, up to 180 characters.

Length1 <= length <= 180
description?string

Board description, up to 500 characters.

Lengthlength <= 500

Response Body

Created board

application/json
  1. response
id*string
name*string
isDefault*boolean

The account's suggested board, a sensible preselection in a picker. A post still names its board in pinterest.boardId.

Example Request
import { Configuration, AccountsApi } from "@onepostly/sdk";const accountsApi = new AccountsApi(  new Configuration({ accessToken: process.env.ONEPOSTLY_API_KEY }));const response = await accountsApi.createAccountBoard({  id: "acc_YOUR_PINTEREST_ACCOUNT_ID",  createPinterestBoardBody: {    "name": "Weeknight Dinners",    "description": "Quick recipes for busy evenings"  },});console.log(response);
Example Response
{  "id": "1035968376946032587",  "name": "Weeknight Dinners",  "isDefault": false}