---
title: "Get Pinterest boards"
method: GET
path: "/uploadposts/pinterest/boards"
tags: ["Platform Integration"]
---

# Get Pinterest boards

`GET /uploadposts/pinterest/boards`

Retrieve all Pinterest boards (public and secret) from a connected Pinterest account. Use the board ID for posting Pins.

## Query parameters

- `profile` string

## Response `200`

Pinterest boards retrieved successfully.

- object
  - `success` boolean
  - `boards` PinterestBoard[]
    - `id` string — Pinterest board ID for posting.
    - `name` string — Display name of the board.
  - `pinterest_account_used` string — Pinterest username of the account used.

## Other responses

- `401` — Unauthorized — Invalid or expired token.

---

[API](https://skmtc.dev/upload-post/apis/upload-post-api.md) · [All operations](https://skmtc.dev/upload-post/apis/upload-post-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upload-post/upload-post-api/revisions/10bd964e4415/schema)