Board Targeting
Pin directly to specific boards for organized content
Postproxy × Pinterest
Create pins on Pinterest with images and videos. Drive traffic with destination links and organized boards.
One API call handles Pinterest pins with media uploads and board targeting.
Traffic Driver
Add destination links to drive traffic from pins to your website
Video Pins
Upload video pins up to 2 GB and 15 minutes long
Custom Covers
Set custom cover images and thumbnail offsets for video pins
curl -X POST "https://api.postproxy.dev/api/posts" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "post": { "body": "10 Tips for Better Photography" }, "profiles": ["pinterest"], "media": ["https://example.com/image.jpg"], "platforms": { "pinterest": { "title": "10 Tips for Better Photography", "board_id": "987654321", "destination_link": "https://example.com/blog/photography-tips" } } }'Pinterest Parameters
Formats
| Format | Description |
|---|---|
pin | Pin (default) |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | No | Title of the pin |
board_id | string | Yes | ID of the public board to pin to |
destination_link | string | No | URL of the destination link |
cover_url | string | No | URL of cover image (video only) |
thumb_offset | integer | No | Thumbnail image offset in seconds (video only) |
Media Constraints
| Media Type | Max Size | Formats | Max Count | Duration |
|---|---|---|---|---|
| Image | 32 MB | jpg, gif, png, webp | 1 | - |
| Video | 2 GB | mp4, mov | 1 | 4s - 15min |
Notes
- Text content: Optional (description)
- Media required: Yes
- Mix video and image: No
View full documentation for all platform-specific features for Pinterest
Why Postproxy for Pinterest?
Skip Pinterest API complexity
No need to handle Pinterest API, OAuth flows, or rate limits. Postproxy handles it all.
Board management simplified
Target specific boards by ID without managing Pinterest's board API separately.
Cross-platform publishing
Publish the same visual content to Pinterest alongside Instagram, TikTok, and more in one API call.
Reliable delivery
Automatic retries and clear status reporting ensure your pins reach Pinterest.
Frequently Asked Questions
Common questions about Pinterest integration
Is a board_id required for Pinterest pins?
Yes, you must specify a board_id to indicate which public board the pin should be added to.
What media formats does Pinterest support?
Pinterest supports images (jpg, gif, png, webp) up to 32 MB and videos (mp4, mov) up to 2 GB with a duration of 4 seconds to 15 minutes.
Can I add a link to my Pinterest pin?
Yes! Use the destination_link parameter to add a clickable link to your pin that drives traffic to your website or landing page.
Can I set a custom thumbnail for video pins?
Yes, you can use cover_url to set a custom cover image, or thumb_offset to select a frame from the video at a specific second.
Can I post text-only content on Pinterest?
No, Pinterest requires at least one image or video for every pin. The post body becomes the pin description.
Ready to get started?
Start with our free plan and scale as your needs grow. No credit card required.