PinBridge icon

PinBridge

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

Actions30

Pin → Publish

AI-generated

Summary

Publish a new pin to a specified Pinterest board using PinBridge, providing mandatory details like account connection, board ID, and pin title, along with optional fields to customize the pin's media and metadata.

Inputs

  • accountId (required) — Pinterest connection/account used for publishing.
  • boardId (required) — Pinterest board ID where the pin will be published.
  • imageSource (required) — Choose whether to reference a PinBridge asset (image or video) or an existing public image URL to provide the pin's media.
  • title (required) — Pin title (max 100 characters).
  • description — Optional pin description (max 800 characters).
  • linkUrl — Optional destination URL for the pin (max 2048 characters).
  • altText — Optional accessibility alt text (max 500 characters) sent to Pinterest.
  • relatedTerms — Optional comma-separated related terms for Pinterest.
  • dominantColor — Optional dominant media color in hex format (e.g., #6E7874).
  • coverImageSource — Optional cover image source for video pins; leave as 'None' to use Pinterest's default keyframe.
  • coverImageUrl — If 'Public Image URL' is chosen as cover image source, provide the public URL for the video cover image (max 2048 characters).
  • coverImageAssetId — If 'Uploaded Asset' is chosen as cover image source, provide the PinBridge uploaded image asset ID used as the video cover image.
  • imageUrl — If using 'Public Image URL' as media source, provide the public image URL accepted by the PinBridge API.
  • assetId — If using 'Uploaded Asset' as media source, provide the PinBridge asset ID returned by the Upload Image or Upload Video operation.
  • idempotencyKey (required) — Deduplication key sent to PinBridge as idempotency_key; defaults to execution ID and item index concatenated.

Output shape

a single record representing the published pin on Pinterest as returned by PinBridge

The output includes all relevant pin details such as IDs, URLs, status, and metadata. If multiple input items are processed, the output is an array of such records, each paired with the corresponding input item. Errors for individual items are returned within the result if 'Continue On Fail' is enabled.

Links

Discussion