Getting Started
Introduction to PinBridge
Your Pinterest publishing infrastructure
What is PinBridge?
PinBridge is a developer-first Pinterest publishing API that handles the complexity of Pinterest integration so you can focus on building your application.
Instead of dealing with Pinterest's OAuth flows, rate limits, and API quirks, PinBridge provides a simple REST API that queues your pin publishing jobs and handles all the heavy lifting.
Key Features
- Simple REST API - Publish pins with a single API call
- Async Job Processing - Never wait for Pinterest's API
- Automatic Retries - Built-in retry logic with exponential backoff
- Webhook Notifications - Get notified when pins are published
- Rate Limit Management - We handle Pinterest's rate limits for you
- Multi-Account Support - Manage multiple Pinterest accounts
How It Works
Pin publishing flow
Step 1
Your App
Sends POST /v1/pins
Step 2
PinBridge API
Accepts request and validates payload
Queue job
Step 3
Job Queue
Runs async workers + retries
Step 4
Pinterest API
Publishes pin to selected board
Success or failure event
Step 5
Webhook
PinBridge notifies your app with pin.published or pin.failed
Step 1
Your App
POST /v1/pins
Step 2
PinBridge API
Queue job
Step 3
Job Queue
Process
Step 4
Pinterest API
Success event
Step 5
Webhook
Notifies your app
- Submit a pin - Send a POST request to
/v1/pinswith your pin payload - Get a queued response - PinBridge returns the created pin resource immediately (status
queued) - Poll status - Use
GET /v1/pins/{pin_id}(orGET /v1/jobs/{job_id}alias) while processing runs asynchronously - Get notified - Optionally receive webhook events (
pin.published/pin.failed)
Use Cases
PinBridge is perfect for:
- E-commerce platforms - Auto-publish products to Pinterest
- Content management systems - Share blog posts and articles
- Marketing automation - Schedule and publish pins at scale
- Social media tools - Build Pinterest integrations without the hassle
- Analytics platforms - Track pin performance across accounts
Next Steps
Ready to get started? Here's what to do next:
- Create an account to access PinBridge and test in sandbox
- Read the Authentication guide
- Follow the Quick Start tutorial
- Run the Python examples
- Explore the API Reference
Need Help?
- Questions? Check our API Reference
- Issues? Contact support
- Examples? Browse Python examples