Pinterest Publishing Docs
Create Pinterest Pins with Postifys: board targeting, image URL fields, proxyDownload, and approval caveats.
Quick answer: Image Pins on a selected connected board (write access depends on Pinterest app approval). Use
POST /api/pinterest/post with Authorization: Bearer YOUR_API_KEY.What Postifys supports
Image Pins on a selected connected board (write access depends on Pinterest app approval).
Product overview: Pinterest integration. Full field reference also lives on API docs.
Endpoint
POST /api/pinterest/post · Auth: API key or session · Target field: boardId when needed
Permissions / scopes (as granted): Board write access as approved for the Postifys Pinterest application
Common fields
boardId- Required; from GET /api/pinterest/boards.title- Required.description- Optional.link- Optional destination URL.imageUrl / mediaUrls- Required public image URL.pinterestUserId- Optional when multiple Pinterest accounts are connected.proxyDownload- Optional; auto for Drive/Dropbox.
cURL example
curl -X POST https://postifys.com/api/pinterest/post \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"boardId": "BOARD_ID",
"title": "Campaign pin",
"imageUrl": "https://example.com/pin.jpg",
"link": "https://example.com"
}'Limitations
- Production writes depend on Pinterest granting required application access.
- Board must be writable by the connected account.
- Media and destination rules follow Pinterest requirements.
See also Media requirements, Errors, and Rate limits.