Pinterest — Postli docs

Home / Docs / Pinterest

Provider

Publish image and video pins to a Pinterest Business account through the Pinterest API v5. Postli sets the title, description, source URL, board, and (optionally) a section within the board.

Requirements

A Pinterest Business account — consumer accounts cannot use the publishing API. Convert in Pinterest Settings → Account management.
At least one board created on the account — pins can’t be saved with no board.
Compliance with the Pinterest Developer Guidelines.

Spec

Account type

Pinterest Business

Auth

Pinterest OAuth 2.0

Token type

30-day access token + 60-day refresh token (Postli refreshes automatically)

Pin types

Image, video, idea (multi-page) — Postli supports image & video

Title

Up to 100 characters

Description

Up to 500 characters

Source URL

Required — the destination the pin links to (Postli short link works perfectly here)

Image

JPEG, PNG · ≤32 MB · 2:3 ratio recommended (1000×1500 px)

Video

MP4, MOV, M4V · ≤2 GB · 4 s – 15 min · 9:16 vertical recommended

Boards / sections

Pin to any board you own; section optional

Auto-comments

Not supported by API — Pinterest does not expose comment publishing

Connect your Pinterest account

Postli manages the OAuth app centrally — you don’t need to register a developer app or paste any API credentials. Go to Integrations → Pinterest → Connect and approve all the listed scopes on Pinterest’s consent screen — partial grants will block board listing or pin creation.

Scopes Postli requests:

boards:read # list boards boards:write # pin to a board pins:read # read existing pins pins:write # publish pins user_accounts:read # identify the connected account

Pin types in detail

Image pin

Single image with title, description, and source URL. The 2:3 vertical ratio (1000×1500) consistently outperforms square or landscape on Pinterest. Postli warns in the channel tab if your media is not 2:3.

Video pin

Single video with cover image, title, description, and source URL. Postli uploads via Pinterest’s media-upload endpoint, polls for transcoding, then creates the pin once the video is ready.

Source URL & UTMs

The source URL is what every pin click leads to. With Postli’s auto-UTM setting on, the URL is decorated with utm_source=pinterest, utm_medium=social, and the campaign tag at publish time — so you see Pinterest revenue attribution out of the box.

Auto-comments

Pinterest’s public API does not expose pin-comment endpoints. Auto-comments are therefore disabled for Pinterest pins. Engagement metrics (saves, clicks, impressions) are read normally.

Rate limits

Pinterest enforces a per-app and per-user rate limit (typically 200 calls per minute per app). Postli batches and back-offs on 429. Pin volume itself is not capped — you can pin hundreds per day.

Gotchas & best practices

Personal accounts can’t use the API. Convert to Business in Pinterest Settings.
Source URL is mandatory. Pinterest will reject pin creation if it’s missing.
2:3 vertical wins. Square pins still publish, but get less reach.
Refresh token expires. If the user doesn’t use Postli for >60 days, the refresh token can expire and a re-auth is required.
Idea pins (multi-page) are not supported by Postli today. Use a video pin for similar effect, or pin pages individually.

Webhooks

Postli does not subscribe to Pinterest webhooks. Engagement is polled.