One API Call to Pin on Pinterest

The Pinterest API v5 requires app review with business use case justification, complex board management, and strict image format requirements. RelayAPI handles OAuth, rate limits, media hosting, and API changes.

No credit card required · Free plan available

POST /v1/posts
const response = await fetch('https://api.relayapi.dev/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer rlay_live_xxxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    content: 'Check out our latest update!',
    platforms: ['pinterest'],
    media: ['https://cdn.example.com/image.jpg'],
  }),
});

Pinterest API v5

  • App access requires Pinterest business account verification and app review with detailed use case documentation
  • Pin creation requires separate board management, and board IDs must be resolved before creating pins
  • Image specifications are strict -- minimum 100x100 pixels, recommended 1000x1500, with specific aspect ratio requirements
  • Rate limits are per-user and per-app with different tiers, and exceeding them results in 24-hour lockouts
  • Video pin creation uses an async processing pipeline with status polling before the pin becomes visible

RelayAPI

  • RelayAPI handles Pinterest business verification and app review so you can start pinning immediately
  • Create pins with board names instead of IDs -- we resolve boards automatically and create them if needed
  • Upload any image and RelayAPI validates dimensions, resizes if needed, and ensures Pinterest format compliance
  • Intelligent rate limit management with per-account tracking, automatic queuing, and lockout prevention
  • Video processing is handled asynchronously with automatic status polling and webhook notifications on completion
Save 3+ hours of development time

Pinterest Business Account Required

Publishing Pins via the Pinterest API requires a Pinterest Business account. Personal accounts must be converted to Business accounts in Pinterest settings.

Supported Content Types

Image PinsVideo PinsIdea PinsProduct PinsCarousel Pins

How It Works

1

Connect Your Account

Authorize your Pinterest account via OAuth in 30 seconds

2

Build Your Integration

Use the REST API or our SDKs to publish content

3

RelayAPI Handles the Rest

We manage publishing, rate limits, and delivery notifications

Ship Faster

Create Pinterest Pins with a single API call. No board ID lookups, no image resizing, no video processing polls. Send your content and link, we handle the rest.

Official API, Zero Hassle

RelayAPI uses the official Pinterest API v5. Your Pins appear natively with full SEO benefits and analytics, while we manage app review, tokens, and format compliance.

Visual Content Optimization

Pinterest rewards specific image dimensions and formats. RelayAPI automatically optimizes your media for maximum reach, handling aspect ratios, resizing, and format conversion.

Frequently Asked Questions

Start Building with Pinterest

Join developers who chose RelayAPI over building with Pinterest API v5 directly.

Get Started Free

© 2026 Relay. All rights reserved.