📋 Pinterest API Review Documentation
This page demonstrates how Postia uses Pinterest's OAuth 2.0 API with full transparency and user control
📌 Pinterest API Workflow Demonstration
How Postia Safely Uses Pinterest's Official API
This page walks Pinterest reviewers through our complete workflow: secure OAuth authentication, user-controlled pin creation, manual scheduling, and transparent data handling. Every action requires explicit user approval.
Secure Pinterest OAuth Login
Postia connects to Pinterest using OAuth 2.0. Users are redirected to Pinterest to authenticate securely. Postia never sees or stores passwords.
"Users click 'Connect Pinterest Account' and are securely redirected to Pinterest's official authorization page."
🔐 Permissions Requested (Minimum Required):
- boards:read — To let users select which board to post pins to
- pins:write — To publish only user-approved pins
- user_account:read — To display the user's profile name & avatar
Postia requests only essential permissions. No analytics access. No unnecessary data access.
User Grants Access via Pinterest
Users are taken to Pinterest's secure authorization screen. They explicitly review and approve which permissions to grant. Users can decline or revoke access anytime.
"User explicitly approves access to boards and pins. This is 100% under the user's control."
Successful Account Connection
Once access is granted, Postia displays the connected account with profile info. Users see their limits and can disconnect anytime with one click.
Displayed Information:
- Connected username
- Profile picture
- Status: "Connected ✓"
- Daily pin posting limit
- Scheduled pins count
- "Disconnect Account" button (revokes access immediately)
Import or Select Products
Users upload their Etsy shop CSV or add products manually. Postia stores product data securely and allows users to build a product library.
"Users import their Etsy products via CSV — Postia duplicates this data only for generating pins."
Select Products for Pin Creation
Users select which products they want to generate pins for. All data comes from their own product library.
Configure Pin Generation Settings
Users configure everything manually before generation. They choose image source, number of pins, and destination link.
User-Controlled Options:
- 📸 Image source (product photos)
- 🔢 Number of pins per product (1, 3, or 5)
- 🔗 Link destination (product URL or custom)
Preview & Edit Every Single Pin
Each generated pin is shown in an approval workflow. Users can edit title, description, link, and schedule — or skip any pin they don't want.
"Users review each pin individually. They can edit title, description, link, board, date, and time. Or skip the pin entirely. Nothing posts without explicit user approval."
🎯 Approval Workflow — User Controls Everything:
- Edit pin title
- Edit pin description
- Change destination link
- Select board from Pinterest API
- Choose date & time to post
- Skip any pin
- All changes require explicit user confirmation
Pin Successfully Posted to Pinterest
After the user schedules the pin, Postia submits it to Pinterest's API. The system confirms successful submission with a green success banner and updates the scheduled queue.
✔ Pin Successfully Created
The system confirms:
- Pin title and description submitted to Pinterest API
- Board and scheduling confirmed
- OAuth authorization verified
- Pin ID generated and stored
- Rate limit checked (50 pins/day limit respected)
Scheduled Pins Queue
All scheduled pins appear in the user's queue with full details. Users can view, edit, reschedule, or cancel any pin. The queue shows the sandbox mode status clearly.
📅 Queue Display — Full User Control:
- Pin thumbnail preview
- Title and description
- Destination board
- Scheduled date & time
- Edit button (reschedule, change board, etc.)
- Cancel / delete button
- Status indicator (Scheduled / Posted / )
🛡️ Safety & Compliance Guarantees
What Postia DOES:
- Uses official Pinterest OAuth 2.0
- Requests minimum permissions
- Stores encrypted OAuth tokens
- Posts only user-approved content
- Respects rate limits (50 pins/day)
- Allows account disconnection anytime
What Postia NEVER Does:
- Auto-post without user approval
- Scrape Pinterest data
- Collect analytics
- Perform bulk operations
- Follow/unfollow accounts
- Engage with user actions
- Access private information
📋 Policy Compliance:
Postia fully complies with Pinterest's Developer Policies, Posting Quality Guidelines, and Community Guidelines. Every action requires explicit user consent.
🔐 Data Handling & Privacy
Postia stores only essential data needed to schedule pins. All sensitive data is encrypted.
✓ Postia Stores:
- • Pinterest user ID
- • OAuth token (encrypted)
- • Pin title & description
- • Image URL
- • Scheduled date/time
- • Board ID
- • Destination link
✗ Postia Never Stores:
- • Pinterest passwords
- • Analytics data
- • Private information
- • Board descriptions
- • User followers/following
- • Engagement metrics
🔒 Token Security:
OAuth tokens are encrypted at rest and only used to perform actions that the user explicitly approves. Tokens are immediately deleted when the user disconnects their Pinterest account.
🎬 Full Workflow Video Demonstration
Below is a complete screen recording showing the entire Postia Pinterest integration workflow in action — from login to scheduling.
📺 Video Content:
- ✓ User connects Pinterest account via OAuth
- ✓ Product CSV import and library management
- ✓ Pin configuration and generation
- ✓ Individual pin preview and editing
- ✓ Board selection and scheduling
- ✓ Scheduled pins queue and management
- ✓ Calendar view and rescheduling options
📧 Support & Questions
For questions about Postia's Pinterest integration or data practices:
support@getpostia.com
Postia is an independent service and is not affiliated with, endorsed by, or connected to Pinterest, Inc.
Last Updated: November 24, 2025
For Pinterest Privacy & Data Handling: Pinterest Privacy Policy