PinBridge icon

PinBridge

Publish, schedule, and manage Pinterest workflows through the PinBridge API

Actions30

Schedule → Create

AI-generated

Summary

Create a scheduled Pinterest pin using a specified PinBridge connection and board with detailed pin attributes including media and publication time.

Inputs

  • accountId (required) — Pinterest connection/account used for scheduled publishing
  • boardId (required) — Pinterest board ID where the scheduled pin will be published
  • runAt (required) — ISO 8601 timestamp indicating when the pin should be published; must include timezone offset
  • imageSource (required) — Determines whether the pin media is referenced by a PinBridge uploaded asset or a public image URL
  • title (required) — Title of the pin (maximum 100 characters)
  • description — Optional description for the pin (maximum 800 characters)
  • linkUrl — Optional destination URL for the pin (maximum 2048 characters)
  • coverImageSource — Optional video cover source: can be none, a public image URL, or a PinBridge uploaded asset
  • coverImageUrl (required) — Required if coverImageSource is 'url'; public URL for the video cover image (maximum 2048 characters)
  • coverImageAssetId (required) — Required if coverImageSource is 'asset'; PinBridge uploaded image asset ID used as video cover
  • imageUrl (required) — Required if imageSource is 'url'; public image URL accepted by PinBridge API
  • assetId (required) — Required if imageSource is 'asset'; PinBridge asset ID returned by an upload operation

Output shape

a list of created schedule records, one per input item

Each schedule record includes details such as schedule ID, associated pin ID, publishing time, status, pin details (title, description, media info), and timestamps. Errors are returned per item if creation fails.

Examples

Example 1: Schedule creation with an uploaded asset

Provide the PinBridge account ID, target board ID, asset ID for the media, and specify the publishing time with timezone offset. Optionally include description, link URL, and cover image if video.

Example 2: Schedule creation referencing a public image URL

Set image source to URL and provide the public image URL and publishing time. Optionally include pin title, description, link URL, and if video, specify cover image URL or asset.

Links

Discussion