---
title: "List Pinterest boards"
method: GET
path: "/v2/social/pinterest/boards"
tags: ["accounts"]
---

# List Pinterest boards

`GET /v2/social/pinterest/boards`

## Request

- Base URL: `https://backend.blotato.com`
- URL: `https://backend.blotato.com/v2/social/pinterest/boards`
- Auth: API key in header `blotato-api-key`

Lists boards owned by a connected Pinterest account. Returns the id and name of each board so callers can pick the boardId required when creating a Pinterest pin via blotato_create_post.

## Query parameters

- `accountId` string, required

## Response `200`

Default Response

- object
  - `items` object[], required: Pinterest boards owned by the connected account. Capped at 250 (the Pinterest page_size limit).
    - `id` string, required: Pinterest board id. Pass this as boardId when creating a pin.
    - `name` string, required: Display name of the board on Pinterest.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Default Response
- `500`: Server error

## Changes

- **2026-08-21** `39e94457ccb2`: 10 info
  - added the optional property `action` to the response with the `401` status
  - added the optional property `action` to the response with the `403` status
  - added the optional property `action` to the response with the `404` status
  - added the optional property `action` to the response with the `422` status
  - …6 more
- **2026-08-11** `51232970f10e`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/blotato/apis/blotato-api/changes/v2/social/pinterest/boards/get.md)

---

[API](https://skmtc.dev/blotato/apis/blotato-api.md) - [All operations](https://skmtc.dev/blotato/apis/blotato-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blotato/apis/blotato-api/revisions/1efa7629dbf3?raw)