List Pinterest boards

List every board the connected Pinterest account owns.

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"
}