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

# List the Pinterest boards of a connected account

`GET /accounts/{id}/boards`

## Request

- Base URL: `https://api.posteahora.com/functions/v1/api`
- URL: `https://api.posteahora.com/functions/v1/api/accounts/{id}/boards`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/posteahora/apis/posteahora-public-api/docs/accounts/:id/boards/get.ts> (a function with typed inputs; its response is checked against the schema)

A Pin is created on a board — pick one here and pass its id as platformOptions.pinterest.boardId. Pinterest accounts only.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `boards` PinterestBoard[]
    - `id` string
    - `name` string
    - `privacy` 'PUBLIC' | 'PROTECTED' | 'SECRET'
    - `pinCount` integer, nullable

## Other responses

- `400`: Not a Pinterest account
- `404`: Account not found in this workspace
- `409`: Account disconnected — reconnect it in the app
- `429`: Pinterest rate limit reached

---

[API](https://skmtc.dev/posteahora/apis/posteahora-public-api.md) - [All operations](https://skmtc.dev/posteahora/apis/posteahora-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/posteahora/apis/posteahora-public-api/revisions/552a8eb6c30f?raw)