Share visually engaging Pins with an external link URL to drive traffic from Pinterest boards.
Create or schedule a Pinterest Pin by setting type: "photo"
, adding your media, specifying url
for the external link, and the album_id
to select the destination board.
Single API call to schedule or publish…
Supports up to 5 photos or 1 video per Pin
Clickable external URL
Specify the target board with album_id
Optional alt text for accessibility
Max Media
1 video or up to 5 photos
Supported Formats
JPEG, PNG, GIF, MP4
Link URL
External links only (use url
field)
Alt Text
Optional (media[].alt_text
)
Board Selection
Use accounts[].album_id
to pick a Pinterest board
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"pinterest": {
"type": "photo",
"text": "Check out our new blog post!",
"media": [
{
"id": "external-0",
"type": "photo",
"path": "https://cdn.example.com/images/post1.jpg",
"thumbnail": "https://cdn.example.com/images/post1-thumb.jpg",
"alt_text": "Screenshot of our blog homepage"
}
],
"title": "Our Latest Blog Article",
"url": "https://publer.com/blog"
}
},
"accounts": [
{
"id": "YOUR_PINTEREST_ACCOUNT_ID",
"scheduled_at": "2025-07-05T14:16:00+02:00",
"album_id": "934145216398624390"
}
]
}
]
}
}
networks.pinterest.type
string
Must be "photo"
.
networks.pinterest.text
string
Caption or description for the Pin.
networks.pinterest.media
array
List of media objects (1 video or up to 5 photos).
networks.pinterest.media[].id
string
"external-X"
or media ID from Publer.
networks.pinterest.media[].path
string
URL to the full-size image or video.
networks.pinterest.media[].thumbnail
string
URL to the thumbnail image.
networks.pinterest.media[].type
string
Must be "photo"
or "video"
.
networks.pinterest.media[].alt_text
string
Accessible description of the image (optional).
networks.pinterest.title
string
Pin title displayed on hover.
networks.pinterest.url
string
Clickable external link URL.
accounts[].id
string
Pinterest account identifier.
accounts[].album_id
string
Board ID where the Pin will be posted.
accounts[].scheduled_at
string
ISO 8601 timestamp for scheduling (omit to publish immediately).
Select Account & Board
Add your Pinterest account.id
and target album_id
.
Upload/Reference Media
Upload up to 5 photos or 1 video to Publer, then reference each with its id
.
Compose Pin
Set type: "photo"
.
Provide text
, title
, and url
.
Optionally add alt_text
.
Schedule or Publish
To schedule, include scheduled_at
.
To publish now, call /posts/schedule/publish
or omit scheduled_at
.
Use high-resolution images or video for best display.
Keep the title and text concise to encourage clicks.
Ensure the URL is valid and leads to valuable content.
Organize Pins into relevant Boards for better discoverability.
Add alt text for accessibility and SEO benefits.