Ship your first Pin in five minutes.

# Verify your key against the rate-meter
curl https://api.pinbridge.io/v1/rate-meter \
  -H "X-API-Key: $PINBRIDGE_KEY"

# Returns a Pinterest consent URL to redirect the user to
curl https://api.pinbridge.io/v1/pinterest/oauth/start \
  -H "X-API-Key: $PINBRIDGE_KEY"

curl -X POST https://api.pinbridge.io/v1/pins \
  -H "X-API-Key: $PINBRIDGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "board_id": "b_78f2a9",
    "image_url": "https://cdn.shop/img/1.jpg",
    "title": "Summer styles 2026",
    "idempotency_key": "launch-123"
  }'

from pinbridge import PinBridge

pb = PinBridge(api_key=PINBRIDGE_KEY)

pin = pb.pins.create(
    board_id='b_78f2a9',
    image_url='https://cdn.shop/img/1.jpg',
    title='Summer styles 2026',
)
print(pin.status)  # queued

{
  "event": "pin.published",
  "pin_id": "pin_8fa2",
  "board_id": "b_78f2a9",
  "status": "published"
}