Platforms

Pinterest

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#

• 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 image: attach one image beside the video and it is used as the cover. A video pin without one is accepted when scheduled but fails when it is sent.
• 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. These refusals answer 400 with the flat body { statusCode, code, message }, not the { error } envelope: TOO_LONG, TOO_MANY_ITEMS, MEDIA_UNSUPPORTED, MEDIA_REQUIRED, MEDIA_TOO_LARGE (over the channel's video size cap), MEDIA_TOO_LONG (over its duration cap). The full list is under Channel-limit refusals.

Settings#

Pass these under platformSettings.pinterest. boardId is required to schedule: a Pinterest post without it is refused with BOARD_REQUIRED in the flat channel-limit body (a draft may still be missing it). The other keys are optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.

{ "pinterest": { "boardId": "1234567890", "title": "Launch day", "link": "https://overads.io/blog" } }