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 pinterest.board_id when calling POST /v1/posts/.

Permissions: Requires accounts:read. Access is limited by the API key creator's current organization membership and stored key ceiling. See Organization permissions.

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

Path Parameters

id*string

Response Body

Boards retrieved

application/json
  1. response

List of Pinterest boards

success*boolean
data*array<>
count*number

Number of boards returned

Example Request
curl -X GET 'https://api.outstand.so/v1/pinterest/accounts/string/boards'
Example Response
{  "success": true,  "data": [    {      "id": "string",      "name": "string",      "description": "string",      "pin_count": 0,      "privacy": "PUBLIC",      "owner": {        "username": "string"      },      "created_at": "string"    }  ],  "count": 0}