Publish image and video pins to Pinterest with POST /v1/posts and platform: "pinterest". The same account serves board management, description edits and analytics.

Quick reference

Property	Value
Title limit	100 characters
Description limit	800 characters, on create and on an edit
Images per pin	1
Videos per pin	1
Image formats	JPEG, PNG, WebP, GIF
Image max size	32 MB
Video formats	MP4, MOV
Video max size	2 GB
Video duration	4 seconds to 15 minutes
Scheduling	Yes
Editing published posts	Description only, 800 characters (blocked by Pinterest's closed beta)
Inbox	No (Pinterest has no API-accessible inbox)
Analytics	Yes (impressions, saves, clicks)

Before you start

Pinterest requires a board to pin to. Create one in Pinterest or with Create a board.

Every pin needs 1 image or 1 video. There are no text-only pins and no carousels or multi-image posts.

Pinterest is a search engine rather than a social feed: people find pins through search and browse, not through followers.

So the title, description and board name matter more than the posting time. A pin keeps surfacing for 3 to 6 months instead of hours.

link is where a click on the pin sends people, so it is the field that drives traffic.

Send boardId on every post. It is optional, but a pin without one lands on whichever board Pinterest returns first, which is rarely the one you meant.

When the account has no boards, or the board list cannot be read, the post fails with "Pinterest requires a boardId. Provide platformSpecificData.boardId."

List the account's boards with GET /v1/accounts/{accountId}/pinterest-boards.

Connect

Call GET /v1/connect/pinterest with profileId on Get OAuth connect URL.

After OAuth, the user picks a default board:

Both run in standard or headless mode, like the other selection platforms. See platforms requiring secondary selection.

Change the default board later with Update Pinterest board, with no second OAuth.

The connecting accounts guide covers the flow and scopes in general. Account health reports what a connected account can do with the scopes the user granted.

In this section

Pins & boards

Publish an image pin or a video pin, manage boards and edit a published pin, plus every platformSpecificData field.

Media requirements

Image and video requirements for Pinterest pins, and the rules for media URLs.

Analytics

Which analytics metrics Pinterest returns for pins.

Limits & errors

Pinterest's missing inbox, what its API does not expose and the common errors when publishing.

Connecting accounts: the OAuth flow and board selection.
Create post: every field of the request.
Edit post: update the description of a published pin.
Media uploads: upload images and videos instead of hosting them.
Pinterest boards and Create Pinterest board: the boards endpoints.

Publish image and video pins to Pinterest with POST /v1/posts and platform: "pinterest". The same account serves board management, description edits and analytics.

Quick reference

Property	Value
Title limit	100 characters
Description limit	800 characters, on create and on an edit
Images per pin	1
Videos per pin	1
Image formats	JPEG, PNG, WebP, GIF
Image max size	32 MB
Video formats	MP4, MOV
Video max size	2 GB
Video duration	4 seconds to 15 minutes
Scheduling	Yes
Editing published posts	Description only, 800 characters (blocked by Pinterest's closed beta)
Inbox	No (Pinterest has no API-accessible inbox)
Analytics	Yes (impressions, saves, clicks)