List Pinterest Board IDs for a Connected Account

Endpoint

GET /api/content/pinterest/boards returns the boards for one connected Pinterest account. Pass the connected accountId as a query parameter and authenticate with the X-API-Key header (a Bearer token also works for dashboard sessions). The data array lists each board with the id to use when publishing.

const API_BASE_URL = 'https://api.wahdx.com';
const API_KEY = process.env.WAHDX_API_KEY;

const accountId = 'PINTEREST_ACCOUNT_ID';
const url = API_BASE_URL + '/api/content/pinterest/boards?accountId=' + encodeURIComponent(accountId);

const response = await fetch(url, {
  headers: { 'X-API-Key': API_KEY }
});
const { data: boards } = await response.json();
console.log(boards);

import os
import requests

API_BASE_URL = 'https://api.wahdx.com'
API_KEY = os.environ['WAHDX_API_KEY']

account_id = 'PINTEREST_ACCOUNT_ID'
response = requests.get(
    f'{API_BASE_URL}/api/content/pinterest/boards',
    params={'accountId': account_id},
    headers={'X-API-Key': API_KEY},
    timeout=30,
)
boards = response.json()['data']
print(boards)

curl -G "https://api.wahdx.com/api/content/pinterest/boards" \
  -H "X-API-Key: $WAHDX_API_KEY" \
  --data-urlencode "accountId=PINTEREST_ACCOUNT_ID"

Response fields

Each item in data describes one board the account can publish to. Use id as pinterestSettings.board_id in the publish request.

Using the board id

Take the id from this endpoint and send it as pinterestSettings.board_id in POST /api/content/post. A video Pin also needs pinterestSettings.cover_image_url. To publish to several Pinterest accounts, call this endpoint once per account; each account has its own boards.

POST /api/content/post
X-API-Key: <server-side key>
Content-Type: application/json

{
  "platform": "pinterest",
  "accountId": "PINTEREST_ACCOUNT_ID",
  "content": "Pin description up to 500 characters",
  "mediaItems": [{ "url": "https://your-domain.com/photo.jpg" }],
  "pinterestSettings": {
    "board_id": "BOARD_ID_FROM_THIS_ENDPOINT"
  }
}

Errors

The endpoint returns a specific status so an integration can react without guessing.

• 400 when accountId is missing or the account is not a Pinterest account.
• 404 when the accountId is not connected to your workspace.
• 401 when the X-API-Key is missing or invalid.