Pinterest publishing is board-first: every Pin needs exactly one image or video and a destination board. UniPost exposes board selection through `platform_options.pinterest` while keeping the top-level publish shape consistent.
Single-image or single-video Pin publishing with board selection.
Pinterest account requirementPlatform requirement: create a Pinterest board before publishing. Sandbox mode may only see boards created through the same API environment.
At a glance
Publishing
Supported
Scheduling
Supported
Analytics
Limited
Inbox
Not supported
Connection
OAuth — Quickstart and White-label both supported
Feature matrix
Feature
Support
Notes
Image Pins
✓
Exactly 1 image
Video Pins
✓
Exactly 1 video
Scheduling
✓
Use scheduled_at
Board selection
✓
Required via platform_options.pinterest.board_id
Analytics
Partial
Impressions, engagements, saves, clicks, and video views when production analytics access is available
Text-only posts
X
Pinterest requires media
Threads
X
Not applicable
Inbox / comments
X
Not part of the UniPost inbox today
Known constraints
Limitation
Why
Daily safety cap
50 publishes/day per connected Pinterest account (UTC reset). Failed posts do not count toward the cap.
Board ID required
Call the Pinterest boards endpoint or use the dashboard board picker before publishing
Analytics account caveat
Some organic analytics are only available when the connected Pinterest user has a business account
No inbox surface
Comment moderation is not in UniPost inbox today
Publishing
Ready to publish?Use the shared Publishing guide for hosted URLs, local file uploads, preflight validation, and async publish status. Then use the Pinterest examples below for platform-specific payload shape.
Publish examples by surface
Each example calls POST/v1/posts with Bearer auth. Swap the account_ids for your own, then copy the snippet for your language.
Image Pin
Video Pin
Media & field requirements
Field
Required
Limits
Notes
media_urls or media_ids
Required
Exactly 1 image or 1 video
Use media_urls for hosted assets or media_ids for local files uploaded via POST/v1/media. Do not mix media types.
platform_options.pinterest.board_id
Required
Pinterest board ID
Select the board the Pin should be created in.
caption
Optional
800 chars
Stored as the Pin description
platform_options.pinterest.title
Optional
100 chars
Pinterest Pin title
platform_options.pinterest.link
Optional
URL
Destination link for the Pin
Hosted URLs: pass the public URL in media_urls. Local files: reserve an upload with POST/v1/media, PUT the bytes to the returned upload_url, then publish with media_ids. Full flow in the Publishing guide.
Media specifications
Per-surface limits for text, images, and video. These are the source of truth UniPost uses for preflight validation and media optimization — treat hard-limit values as enforced and "recommended" values as platform guidance.
Single-image Pin. Vertical 2:3 creative usually performs best.
Type
Requirement
Value
Text
Title
100 chars
Text
Description
800 chars
Image
Formats
JPG, JPEG, PNG, WebP
Image
Max per post
1
Image
Max file size
20 MB
Image
Aspect ratio
2:3 recommended
Video Pin
Single-video Pin.
Type
Requirement
Value
Text
Title
100 chars
Text
Description
800 chars
Video
Formats
MP4, MOV
Video
Max per post
1
Video
Max file size
2 GB
Video
Duration
Up to 15 min
Platform-specific options
Option
Values
Notes
platform_options.pinterest.board_id
string
Required board ID
platform_options.pinterest.title
string
Optional Pin title
platform_options.pinterest.link
URL
Optional destination URL
Analytics
Metric
Support
Notes
Impressions
✓
Supported for approved Pinterest API access
Likes / engagements
✓
Mapped from Pinterest engagement metrics
Comments
✓
Comment count when returned by Pinterest
Saves
✓
Pinterest save count
Clicks
✓
Outbound click metrics
Video views
X
Not mapped by this integration yet
Reach
X
Not exposed by this integration
Shares
X
Not exposed by this integration
Connection modes
Pick the setup that matches how the account is owned. Quickstart is fastest when you publish to your own accounts; White-label is required when your customers bring their own accounts through a branded flow. Full setup details in Quickstart and White-label.
Mode
Best for
App / credentials
Availability
Quickstart
Fast setup — UniPost handles OAuth
UniPost-managed app
Free / paid quota
White-label
Your customers connect their own accounts
Your OAuth app
Paid plans only
Platform requirement: create a Pinterest board before publishing. Sandbox mode may only see boards created through the same API environment.
