Create a Pinterest board

Create a new board on a connected Pinterest account to use as the target when publishing pins through Outstand.

Create a new board on the connected Pinterest account. Privacy defaults to PUBLIC if omitted. The returned id can be used as pinterestConfiguration.board_id when publishing pins via POST /v1/posts/.

POST/v1/pinterest/accounts/{id}/boards

Path Parameters

idstring

Request Body

namestring

Board name

Length1 <= length
description?string

Optional board description

privacy?string

Board privacy. Defaults to PUBLIC

Value in"PUBLIC" | "PROTECTED" | "SECRET"

Response Body

const body = JSON.stringify({  "name": "Travel inspiration"})fetch("https://api.outstand.so/v1/pinterest/accounts/string/boards", {  method: "POST",  headers: {    "Content-Type": "application/json"  },  body})
{
  "success": true,
  "data": {
    "id": "987654321098765432",
    "name": "Summer Outfits",
    "description": "My favourite summer looks",
    "pin_count": 42,
    "privacy": "PUBLIC",
    "owner": {
      "username": "myaccount"
    },
    "created_at": "string"
  }
}
{
  "success": false,
  "error": "Social account not found"
}
{
  "success": false,
  "error": "Social account not found"
}
{
  "success": false,
  "error": "Internal server error"
}