Pinterest

Configure the OwlStack WordPress plugin to publish pins to your Pinterest boards.

Prerequisites

You need a Pinterest Business account and API access.

Getting Pinterest API Credentials

Convert to a Pinterest Business account
Go to the Pinterest Developer Portal
Create a new app
Generate an Access Token with pins:read, pins:write, and boards:read scopes
Find your Board ID from your board's URL or via the API

Settings

Navigate to OwlStack > Pinterest in the WordPress admin.

Field	Description
Access Token	Pinterest API access token
Board ID	The target board's numeric ID

Step-by-step

Go to OwlStack > Pinterest in your WordPress admin
Paste your Access Token
Enter your Board ID
Click Save Settings

Testing

After saving your settings:

Click Test Connection to verify your access token and board ID
Click Send Test Message to create a test pin
Check your Pinterest board to confirm the pin appeared

Publishing

Once configured, Pinterest appears as a toggle in the OwlStack meta box on post edit screens.

Programmatic publishing

// Create a pin with an image (required)
owlstack()->pinterest('Check out this article!', [
    'type' => 'photo',
    'url'  => 'https://example.com/image.jpg',
]);

Image Required

Pinterest requires an image for every pin. Text-only pins are not supported.

Constraints

Constraint	Value
Max description length	500 characters
Max title length	100 characters
Supported image types	JPEG, PNG
Max image size	20 MB
Recommended aspect ratio	2:3

Troubleshooting

Issue	Solution
"Unauthorized" error	Access token may have expired; regenerate it
"Board not found"	Verify the Board ID is correct
"Image required"	Pinterest requires an image for every pin
Pin not visible	Check your board's visibility settings

On this page