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

# List Pinterest boards

`GET /v2/social/pinterest/boards`

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

---

[API](https://skmtc.net/blotato/apis/blotato-api.md) · [All operations](https://skmtc.net/blotato/apis/blotato-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blotato/blotato-api/revisions/c93447ba6b9d/schema)