GET`/social-media/{socialMediaId}/pinterest-boards`

Retrieves all Pinterest boards for a connected Pinterest account. Use the boardId field when setting pinterestBoardId on a Pinterest post.

https://api.postfa.st/Auth: pf-api-keyRate limit: 90 requests per hour

Usage

Use the boardId field when setting pinterestBoardId in the controls object when creating Pinterest posts.

Syncing new boards

New boards created on Pinterest do not appear automatically. Open the Accounts page in your PostFast dashboard, find your Pinterest account, and click Sync Boards to refresh the list.

Path parameters

socialMediaIdstring (UUID)required

The id of the connected Pinterest social media account.

Response

200 OK An array of objects, each representing a Pinterest board.

idstringoptional

Internal PostFast board id.

boardIdstringoptional

Pinterest's native board id (use this for pinterestBoardId).

namestringoptional

Board name.

descriptionstring | nulloptional

Board description.

imageUrlstring | nulloptional

Board cover image URL.

Request

curl -X GET "https://api.postfa.st/social-media/550e8400-e29b-41d4-a716-446655440000/pinterest-boards" \
  -H "pf-api-key: YOUR_WORKSPACE_API_KEY"

Response200 OK

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "boardId": "1234567890123456789",
    "name": "Travel Inspiration",
    "description": "My favorite travel destinations",
    "imageUrl": "https://i.pinimg.com/..."
  },
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "boardId": "9876543210987654321",
    "name": "Recipe Ideas",
    "description": null,
    "imageUrl": "https://i.pinimg.com/..."
  }
]

GET/social-media/{socialMediaId}/pinterest-boards

Path parameters

Response

GET`/social-media/{socialMediaId}/pinterest-boards`