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

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

  1. Submit a pin - Send a POST request to /v1/pins with your pin payload
  2. Get a queued response - PinBridge returns the created pin resource immediately (status queued)
  3. Poll status - Use GET /v1/pins/{pin_id} (or GET /v1/jobs/{job_id} alias) while processing runs asynchronously
  4. 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:

  1. Create an account to access PinBridge and test in sandbox
  2. Read the Authentication guide
  3. Follow the Quick Start tutorial
  4. Run the Python examples
  5. Explore the API Reference

Need Help?