Pinterest publishes photo, carousel and video. Every post needs media, so there are no text-only posts. Media accepted: images and video. Comments are not available: The Pinterest API has no endpoint for reading comments on a Pin. Direct messages are not available. Post metrics are available. First comments are not supported. eksis publishes at most 100 posts per account per rolling 24 hours.
Post types
| Type | API value | What it publishes | Media items | Accepts |
|---|---|---|---|---|
| Photo | photo | One image as a Pin. | 1 | Images |
| Carousel | carousel | Several images as one carousel Pin. | 2 to 5 | Images |
| Video | video | One video Pin. | 1 | Video |
Media requirements
Photo (photo)
- Images: PNG, JPEG, up to 20 MB, aspect ratio 1:2 to 1.91:1, at least 600 px wide.
Carousel (carousel)
- Images: PNG, JPEG, up to 20 MB, aspect ratio 1:2 to 1.91:1, at least 600 px wide.
Video (video)
- Video: MP4, MOV, M4V, up to 2 GB, 4 s to 15 min long, aspect ratio 1:2 to 1.91:1.
Text limits
| Field | Limit | Unit | Note |
|---|---|---|---|
settings.title | 100 | characters | |
settings.link | 2,048 | characters | |
settings.altText | 500 | characters |
Settings
Options for Pinterest go in targets[].settings of create and update post requests.
| eksis option | Field | Type | Values | Required | Applies to |
|---|---|---|---|---|---|
| Board: Board the Pin is saved to. Required; list the boards of the channel to pick one. | settings.boardId | string | from List Pinterest boards | Yes | All types |
| Pin title: Pin title, shown under the preview. | settings.title | string | No | All types | |
| Destination link: Where people land when they click the Pin. | settings.link | string | No | All types | |
| Alt text: Alt text for the image, read by screen readers. | settings.altText | string | No | photo, carousel |
A value of the wrong type, or outside the allowed values, is refused with 422 and the code validation.failed, drafts included. An unknown key is dropped and reported in data.warnings.
{
"channelId": "CHANNEL_ID",
"contentType": "photo",
"settings": {
"boardId": "1092474272376819712",
"title": "Weeknight pasta",
"link": "https://example.com/recipe",
"altText": "A bowl of pasta on a wooden table"
}
}Comments and messages
- First comment: not supported. Pinterest has no comments API. A Pin carries its own destination link, which is where a first comment would have pointed anyway. A
firstCommentsent to this platform is refused with422and the codefirst_comment.unsupported. - Comments: not available. The Pinterest API has no endpoint for reading comments on a Pin.
- Private reply to a comment: not supported.
- Direct messages: not available. Pinterest has no messaging API for third-party apps.
Analytics
- Post metrics:
reach,impressions,likes,comments,saves,profileVisits. - Audience: follower count is tracked.
Daily limit
eksis publishes up to 100 posts per Pinterest channel a day. A post over the limit is postponed, not failed.
Good to know
- Every Pin needs a board. List the boards of the channel to pick boardId.
- A video Pin uses its first frame as the cover.
Webhook events
Events a Pinterest channel can send to your webhook endpoints:
Rules verified on September 5, 2026.
Bluesky
Bluesky publishes text, photo and video. Text-only posts are allowed (text). Media accepted: images and video. Comments can be read, and you can reply, hide and like them. Direct messages are not available. Post metrics are available. A first comment can be posted right after publishing. eksis publishes at most 300 posts per account per rolling 24 hours.
DEV Community
DEV Community publishes post. Text-only posts are allowed (post). Media accepted: images. Comments can be read but not acted on. Direct messages are not available. Post metrics are available. First comments are not supported. eksis publishes at most 30 posts per account per rolling 24 hours.