Pinterest Video Pins in composer, API & MCP
Pinterest video Pins + cover images are now fully supported across posterly:
- Composer: Schedule a single video Pin, extract a frame or upload a custom cover, and keep carousel Pins image-only.
- Public API v1 (
/api/v1/posts,create_posts_batch): Passpost_type: "video", a single video media URL,platform_settings.cover_image_url(orvideo_cover_url), plus the requiredboard_id. Validation now correctly accepts video Pins (single video, no mixing with images or carousels). - MCP / Agent tools:
get_platform_schema("pinterest")now surfacespost_type(image/video/carousel),cover_image_url, and an updated example. Thecreate_posttool description and settings handling include video Pins. - Platform discovery:
GET /api/v1/platformsand the /api-platforms page reflect the complete capabilities.
This brings the dashboard composer, external API, and AI agent interfaces into parity so power users, Zapier-style automations, and MCP agents can schedule video Pins the same way.
How to use (API example)
{
"account_id": 123,
"caption": "Check out the new launch video ✨",
"post_type": "video",
"media_url": "https://.../launch.mp4",
"platform_settings": {
"board_id": "9876543210",
"title": "Launch video",
"cover_image_url": "https://.../cover.jpg"
}
}
Notes:
- Video Pins still require a public, fetchable cover image (JPEG/PNG). The same validation and HEAD checks used in the dashboard apply.
- Carousels remain image-only (2–5 images).
- We continue to use the direct
video_urlsource for simplicity and reliability with Supabase media. The official Pinterest media registration +video_idflow is noted in code for future migration if processing volume grows. - No new OAuth scopes required — your existing
pins:writeconnection works.
See the updated platform schema docs and call get_platform_schema before building Pinterest automations.
Related: Pinterest analytics & video covers changelog
Bonus: As part of the platform API audit, we also published a detailed implementation plan for Bluesky video support (3-minute clips, proper app.bsky.embed.video + video.bsky.app processing flow). The plan is tracked in docs/planning/bluesky-video-support.md and will be executed on a follow-up branch once Pinterest ships. Bluesky remains the last production platform without native video — coming soon!


