PostZen
Accounts

Set default Pinterest board

PUT
/v1/accounts/{accountId}/pinterest-boards

Verifies a Pinterest board and stores it as the account default used when a pin target omits settings.boardId. This endpoint requires a read-write API key.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Path Parameters

accountId*string

PostZen id of a connected Pinterest account.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/accounts/string/pinterest-boards" \  -H "Content-Type: application/json" \  -d '{    "defaultBoardId": "123456789012345678",    "defaultBoardName": "Product inspiration"  }'
{  "message": "Default Pinterest board updated successfully",  "account": {    "_id": "j97kp4mw2xnv6r1t8c3zq5bs9fh0yg4d",    "platform": "pinterest",    "providerAccountId": "987654321098765432",    "profileId": {      "_id": "jh72r5nqk9wx3v8m1t4cz6bs0fy5dg3e",      "name": "Marketing Team",      "slug": "marketing-team",      "color": "#4caf50"    },    "username": "acme",    "displayName": "Acme",    "status": "connected",    "isActive": true,    "connectedAt": "2026-06-19T16:00:00.000Z",    "defaultBoardId": "123456789012345678",    "defaultBoardName": "Product inspiration"  }}
{  "error": "board_not_found"}
{  "error": "Unauthorized"}
{  "error": "API key requires read_write permission"}
{  "error": "Not found"}
{  "error": "not_connected"}
{  "error": "rate_limited",  "retryAfter": 30}
{  "error": "Failed to create post"}
{  "error": "request_failed"}

Create Pinterest board POST

Creates a board for the connected Pinterest account. This endpoint requires a read-write API key.

List Pinterest boards for the connect flow GET

Lists boards after Pinterest OAuth completes so the client can show a board picker. The state handle remains valid for board selection for 30 minutes from connect-flow creation. This endpoint requires a read-write API key.