Pinterest Setup

Configure Pinterest integration through the Pinterest Developer Portal.

Prerequisites

• Pinterest Business account
• Approved developer app

Required Scopes

Scope	Purpose
boards:read	Read user's boards
boards:write	Create/edit boards
pins:read	Read user's pins
pins:write	Create/edit pins
user_accounts:read	Read user profile info

Optional Scopes

Scope	Purpose
ads:read	Read ad accounts
ads:write	Manage ads
catalogs:read	Read product catalogs
catalogs:write	Manage product catalogs

Callback URL

https://api.tendsocial.com/api/social/accounts/callback/pinterest

Set in: Pinterest Developer Portal → Your App → Redirect URIs

Environment Variables

PINTEREST_APP_ID=your_app_id
PINTEREST_APP_SECRET=your_app_secret

Platform Limitations

Feature	Status
Standard pins	✅ Supported
Video pins	✅ Supported
Idea pins/Stories	❌ Not available via API
Carousel pins	✅ Supported
Rich pins	✅ Auto-generated from link metadata
Comments	❌ Not available via API
Analytics	✅ Supported

Pin Requirements

Type	Max Size	Formats
Images	20MB	JPG, PNG, GIF, WEBP
Videos	2GB	MP4, MOV

Recommended Dimensions

• Standard pins: 1000 x 1500px (2:3 ratio)
• Square pins: 1000 x 1000px
• Video pins: 1000 x 1500px or 1080 x 1920px

Sandbox vs Production

Environment	Users	Rate Limits
Sandbox	App owner only	10 calls/minute
Production	All users	1000 calls/minute

To move to production:

1. Complete app review in Developer Portal
2. Provide privacy policy and terms URLs
3. Demonstrate app functionality
4. Wait for Pinterest review team

Token Expiration

• Access tokens: 30 days
• Refresh tokens: 365 days

TendSocial automatically handles token refresh.