Pins to a board; every post needs a boardId from get_pinterest_boards.
What works today
Our build and verification state for each feature. Only states the platform has confirmed are shown as working; everything else is built against the platform's official docs and waits for live credentials or approval. “With limits” means it works with a caveat, usually spelled out in the notes of the last table on this page.
| Feature | State |
|---|---|
| Connect (OAuth) | Built, awaiting credentials |
| Account discovery | Built, awaiting credentials |
| Token refresh | Built, awaiting credentials |
| Disconnect | Built, awaiting credentials |
| Text post | Not offered by the platform |
| Image post | Built, awaiting credentials |
| Multi-image post | Built, awaiting credentials |
| Video post | Built, awaiting credentials |
| Reels / Shorts | Not offered by the platform |
| Carousel | Built, awaiting credentials |
| Thread / reply chain | Not offered by the platform |
| Poll | Not offered by the platform |
| Link preview | Not offered by the platform |
| Platform metadata overrides | Built, awaiting credentials |
| Publish status | Built, awaiting credentials |
| Delete post | Built, awaiting credentials |
| Native scheduling | Not offered by the platform |
| Analytics | Planned |
| Comments (read) | Not offered by the platform |
| Replies | Not offered by the platform |
| Comment moderation | Not offered by the platform |
| Messaging | Not offered by the platform |
| Automations (keyword replies) | Not offered by the platform |
| Inbound webhooks | Not offered by the platform |
Limits
From the connector's capability manifest 0.2.0 (checked against the platform's docs on 2026-10-21). validate_post and POST /v1/posts/validate check all of these before anything is sent.
| Text | 800 characters |
|---|---|
| Media per post | 5 |
| Images | image/jpeg, image/png, image/webp, image/gif up to 20 MB |
| Video | video/mp4, video/quicktime up to 2000 MB, up to 900 s |
platformSpecificData
Options for this platform, set per account in a post's platforms list.
| Field | Type | Notes |
|---|---|---|
boardId (required) | string | |
boardSectionId | string | |
title | string | |
link | string | |
altText | string | |
dominantColor | string | |
coverImageMediaId | string | |
coverKeyFrameMs | integer |
What the platform offers
| Operation | Availability | Notes |
|---|---|---|
connect | supported | Source |
account_discovery | supported | Source |
token_refresh | supported | Continuous refresh tokens: 60 days, renewed on every refresh. Source |
disconnect | supported | No revocation endpoint in v5: disconnect deletes our copy; the user can remove the app in Pinterest settings. Source |
post.text | unsupported by provider | Every pin needs an image or a video. Source |
post.image | supported | Trial access: pins and boards are visible only to the app owner. Source |
post.multi_image | supported | Carousel of 2–5 images. Trial access: pins and boards are visible only to the app owner. Source |
post.video | supported | Upload via POST /media, then a video_id pin. Needs Standard access; the sandbox can't create video pins (https://developers.pinterest.com/docs/developer-tools/sandbox/). Source |
post.short_video | unsupported by provider | No separate short-video format; video is a normal pin. Source |
post.carousel | supported | multiple_image_urls / multiple_image_base64, 2–5 images. Source |
post.thread | unsupported by provider | No threads. Source |
post.poll | unsupported by provider | No polls. Source |
post.link_preview | unsupported by provider | Not applicable: a pin carries its own destination link. Source |
post.story | unsupported by provider | No stories in the public API. Source |
post.delete | supported | Source |
post.native_schedule | unsupported by provider | No scheduling field on pin create. Source |
post.status | supported | Image pins are created synchronously; video waits for media processing. Source |
analytics.post | not yet implemented | GET /pins/{id}/analytics; arrives with analytics (Phase 10). Source |
analytics.account | not yet implemented | GET /user_account/analytics; arrives with analytics (Phase 10). Source |
comments.read | unsupported by provider | No comments endpoints in v5. Source |
comments.reply | unsupported by provider | No comments endpoints in v5. Source |
comments.moderate | unsupported by provider | No comments endpoints in v5. Source |
messaging | unsupported by provider | No messaging endpoints in v5. Source |
webhooks.inbound | unsupported by provider | No webhooks in v5. Source |