List Pinterest boards

List every board a connected Pinterest account owns to populate a board picker before publishing a pin.

List every board the connected Pinterest account owns. Results are paginated by Pinterest's bookmark parameter under the hood and aggregated into a single response.

Use case: populate a board picker before publishing a pin. Pass the chosen board's id as pinterestConfiguration.board_id when calling POST /v1/posts/.

GET/v1/pinterest/accounts/{id}/boards

Path Parameters

idstring

Response Body

fetch("https://api.outstand.so/v1/pinterest/accounts/string/boards", {  method: "GET"})
{
  "success": true,
  "data": [
    {
      "id": "987654321098765432",
      "name": "Summer Outfits",
      "description": "My favourite summer looks",
      "pin_count": 42,
      "privacy": "PUBLIC",
      "owner": {
        "username": "myaccount"
      },
      "created_at": "string"
    }
  ],
  "count": 12
}
{
  "success": false,
  "error": "Social account not found"
}
{
  "success": false,
  "error": "Internal server error"
}