---
title: "List the boards of a Pinterest account"
method: GET
path: "/social-accounts/{id}/pinterest-boards"
tags: ["Accounts"]
---

# List the boards of a Pinterest account

`GET /social-accounts/{id}/pinterest-boards`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/social-accounts/{id}/pinterest-boards`
- Auth: HTTP bearer

Returns every board the account can pin to, secret boards included. Pass the chosen `id` as `pinterestConfigs[].boardId`, or its `name` as `pinterestConfigs[].boardName`. A board belongs to one Pinterest account, so list the boards of each account you post to.. Requires the `posts.draft` permission.

## Path parameters

- `id` string, required

## Headers

- `X-Workspace-Id` string

## Response `200`

Boards of the account

- object
  - `boards` PinterestBoard[]
    - `id` string: Pass as `pinterestConfigs[].boardId`, or pass `name` as `pinterestConfigs[].boardName`
    - `name` string
    - `description` string
    - `privacy` string: `PUBLIC`, `PROTECTED` or `SECRET`, as Pinterest reports it
    - `pinCount` integer

## Other responses

- `400`: Pinterest refused the request, usually because the account must be reconnected
- `401`: Invalid or missing API key
- `403`: The key's role does not hold `posts.draft`
- `404`: Account not found, or not a Pinterest account
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)