Pinterest: posztolási szabályok és beállítások
Mit fogad el a Pinterest csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Basics
pinterestPost types
The same channel accepts more than one kind of post, and each kind has different requirements. The table shows what you need for each.
| Type | Media | Notes |
|---|---|---|
| Pin with an image | 1 image, required | The board is required, and it expects an ID. |
| Pin with a video | 1 video | No extra notes. |
Rules
- The board is required, and it expects an ID, not a name. You fetch the list of boards with the channel's tool call.
Settings fields
These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.
| Field | Type | Required | What it does |
|---|---|---|---|
| board | string (id) | yes | The destination board ID. |
| title | string, up to 100 characters | no | The pin title. |
| link | string (URL) | no | The pin's destination URL. |
| dominant_color | string | no | The pin's dominant color, as a hex code. |
Examples
Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Pin with a destination URL
The board ID comes from the channel tool call: POST /integration-trigger/:id, methodName "boards".
{
"integration": { "id": "<pinterest-csatorna>" },
"value": [{
"content": "<p>A pin leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/pin.jpg" }]
}],
"settings": {
"__type": "pinterest",
"board": "<tabla-azonosito>",
"title": "A pin címe",
"link": "https://pelda.hu/termek"
}
}The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.