Platforms
Pinterest over the overads API: status, connection, limits, media rules and platformSettings keys.
Status: Live. Posts created over the API deliver to this channel today.
Publishes today: one image or one video per pin, to a board you pick.
Connecting
OAuth through Pinterest, in the app. The app lists the account's boards for boardId.
Once connected the account appears in GET /connections with platform: "pinterest". Use its id in connectionIds.
Limits
| Characters | 500 for the description; 100 for the title. |
| API id | pinterest |
- One image, or one video (mp4, mov or m4v, 4 seconds to 15 minutes, up to 2 GB). Media is required.
- A video pin needs a cover: attach one image beside the video and it is used as the cover. Without one the first frame is used when the server can extract it, and the pin is refused otherwise.
- A video is registered with Pinterest, uploaded and processed before the pin is created, so a video pin can take a few minutes to land.
Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. A video over the channel's size cap is MEDIA_TOO_LARGE; over its duration cap is MEDIA_TOO_LONG.
Settings
Pass these under platformSettings.pinterest. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.
| Key | Value | Meaning |
|---|---|---|
boardId | string, up to 64 | The board to pin to |
title | string, up to 100 | Pin title |
link | https URL, up to 2,048 | Destination link |
altText | string, up to 500 | Alt text for the image |
{ "pinterest": { "boardId": "1234567890", "title": "Launch day", "link": "https://overads.io/blog" } }