PricingDocs

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.

Get started freeView API docs

No credit card required · Free plan available

POST /v1/posts
const res = await fetch("https:">//api.relayapi.dev/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer rlay_live_xxxx",
    "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 about 30 seconds.

2

Build your integration

Use the REST API or our SDKs to publish content from your stack.

3

We handle the rest

RelayAPI manages 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

Do I need a Pinterest Business account?

Yes. The Pinterest API only supports Business accounts. You can convert a personal account to a Business account for free in your Pinterest settings.

What content types can I publish to Pinterest through RelayAPI?

RelayAPI supports Image Pins, Video Pins, Idea Pins (multi-page stories), Product Pins with shopping metadata, and Carousel Pins. All with automatic format optimization.

How does RelayAPI handle Pinterest's image requirements?

Pinterest recommends 1000x1500 pixel images with a 2:3 aspect ratio. RelayAPI validates your images, warns about suboptimal dimensions, and can resize automatically to maximize Pin performance.

Can I manage Pinterest boards through RelayAPI?

Yes. You can create boards, list existing boards, and specify target boards by name when creating Pins. RelayAPI resolves board names to IDs automatically.

Explore other platforms

InstagramX / TwitterLinkedInWhatsAppBlueskyGoogle BusinessTikTokFacebookYouTubeThreadsRedditTelegramSnapchatMastodonDiscordTwilio SMS

Start building with Pinterest.

Join developers who chose RelayAPI over wiring up Pinterest API v5 by hand.

Get started freeRead the docs