List Pinterest Boards

List public Boards owned by a connected Pinterest account.

GEThttps://api.postpiper.ai/v1/accounts/{accountId}/boards

Use the returned Board ID as platform_fields.board_id in a Pinterest draft. Only your active Pinterest accounts can be queried. Pass bookmark to load the next page.

Path and query parameters

Name	Type	Description
accountId	UUID, required	Your connected Pinterest account ID.
bookmark	string, optional	Pagination bookmark from the previous response.

Example request

Terminal

curl -H "Authorization: Bearer $POSTPIPER_API_KEY" "https://api.postpiper.ai/v1/accounts/<account-uuid>/boards"

Response

200 OK. Returns public Boards and a bookmark.

JSON

{
  "boards": [
    {
      "id": "123456789",
      "name": "Ideas",
      "privacy": "PUBLIC"
    }
  ],
  "bookmark": null
}

Errors

401Missing or invalid API key.
403API key lacks the required scope.
403Missing scope or Pinterest app access denied.
404Owned Pinterest account not found.
429Pinterest rate limit reached.