Skip to main content

Settings Schema

When creating a Pin on Pinterest, use the following settings schema:

Fields

FieldTypeRequiredDescription
__typestringYesMust be pinterest
boardstringYesBoard ID to pin to
titlestringNoPin title (max 100 characters)
linkstringNoDestination URL
dominant_colorstringNoDominant color for the pin

board

The board ID where the pin will be saved. This is required and must be a valid board ID from your Pinterest account.
Get board IDs by using Groniz’s UI to view your boards, or by using Pinterest’s API directly.

title

Optional pin title with a maximum of 100 characters. Optional destination URL. When users click “Visit” on your pin, they’ll be taken to this URL.

dominant_color

Optional hex color code that represents the dominant color of your pin. Pinterest may use this for visual presentation.

Complete Example

Basic Pin

Pin with All Options

Simple Pin (Minimal Settings)