> ## Documentation Index
> Fetch the complete documentation index at: https://connect.trypost.it/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Pinterest boards

> Boards for a Pinterest account. Use an id as platforms[].meta.board_id.

Throttled to **60 requests / minute**.

<ParamField path="id" type="string" required>
  Pinterest social account UUID. Other platforms return `422`.
</ParamField>

<ResponseField name="boards" type="array">
  `{ "id", "name" }` — send `id` as `platforms[].meta.board_id`.
</ResponseField>

<ResponseField name="truncated" type="boolean">
  `true` when Pinterest returned more boards than this call fetched.
</ResponseField>

`401` if the token is expired. `403` / `429` / `502` on upstream Pinterest errors.

<RequestExample>
  ```bash theme={null}
  curl https://connect.trypost.it/api/social-accounts/b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e/boards \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "boards": [
      { "id": "1234567890123456789", "name": "Product shots" }
    ],
    "truncated": false
  }
  ```
</ResponseExample>