How to Schedule Pinterest Pins via API
Publish pins to Pinterest boards using the PostFast API. Schedule single images, videos, and carousel pins with destination links.
Pinterest pins allow you to share visual content that links back to your website or content. Using the PostFast API, you can schedule pins to specific boards on your Pinterest account.
Every Pinterest pin requires a board ID (pinterestBoardId) to specify where the pin should be published. You can optionally include a destination link (pinterestLink) that users will visit when they click the pin.
The content field is automatically parsed for Pinterest: the first line becomes the pin title (max 100 characters), and the remaining lines become the pin description (max 800 characters).
API Parameters
| Parameter | Type | Description |
|---|---|---|
pinterestBoardId | string | The ID of the Pinterest board to publish the pin to. Required for all Pinterest posts. |
pinterestLink | string | Destination URL when users click the pin. If omitted, the pin will not have a clickable destination. |
Code Example
const response = await fetch('https://api.postfa.st/social-posts', {
method: 'POST',
headers: {
'pf-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"posts": [
{
"content": "25 Easy Meal Prep Ideas for Busy Weeknights\n\nSave hours every week with these simple, healthy recipes. Perfect for batch cooking and portion control. Includes shopping list and storage tips!",
"mediaItems": [
{
"key": "image/a1b2c3d4-e5f6-7890-1234-567890abcdef.jpg",
"type": "IMAGE",
"sortOrder": 0
}
],
"scheduledAt": "2025-01-31T10:00:00.000Z",
"socialMediaId": "uuid-of-pinterest-account"
}
],
"controls": {
"pinterestBoardId": "1234567890123456789",
"pinterestLink": "https://yourblog.com/meal-prep-ideas"
}
})
});
const data = await response.json();
Did You Know?
Tips
Structure your content with the title on the first line, followed by a blank line, then your description
Always include a pinterestLink to drive traffic to your website or landing page
Use high-quality vertical images (2:3 aspect ratio) for best visibility in the Pinterest feed
Carousel pins work great for step-by-step tutorials, product collections, or before/after content
Schedule pins to Pinterest and 7 other platforms from one API
Common Pitfalls
pinterestBoardId is required for all Pinterest posts. The request will fail without it.
Pinterest carousel pins only support static images (2-5 images). Videos cannot be included in carousels.
Users must have connected their Pinterest account and have at least one board before scheduling pins.
If your first line exceeds 100 characters, it will be truncated. Keep titles concise and impactful.
Frequently Asked Questions
How is the content field parsed for Pinterest?
The first line of your content becomes the pin title (max 100 characters). Everything after the first line break becomes the description (max 800 characters).
Is pinterestLink required?
No, it is optional. However, pins without a destination link will not drive traffic to your website. We recommend always including a link.
How do I create a carousel pin?
Include 2-5 IMAGE items in your mediaItems array with sequential sortOrder values. Pinterest will automatically create a carousel pin. Note: videos are not supported in carousels.