Skip to content
Stackposts
Product guide

Pinterest API

Pinterest API Integration The Pinterest API module allows Stackposts administrators to connect the platform to Pinterest for scheduling and automating pin publishing across boards....

2 mins read
StackPosts guide

Pinterest API

Use this guide to configure the connection safely, then verify the account and permissions before you publish or automate.

Use this guide

  1. Prepare the provider credentials and callback values required for this connection.
  2. Enter them in the related settings area, save, and connect one safe test account.
  3. Verify the returned name, status, and permissions before using the connection.

Detailed steps

Pinterest API Integration

The Pinterest API feature allows Stackposts administrators to connect the platform to Pinterest for scheduling and automating pin publishing across boards. This feature uses OAuth-based integration and requires a Pinterest Developer App.


⚙️ Configuration Fields

To configure the Pinterest API, complete the following:

  • Status

    • Enable: Activates Pinterest integration features.

    • Disable: Disables Pinterest-related functionality.

  • Mode
    Choose between:

    • Live: For production usage.

    • Sandbox: For testing and development.

  • App ID
    Your Pinterest application’s unique ID, issued upon app registration.
    Example: 1485555

  • App Secret
    A secure key that validates your app’s identity in OAuth flows.
    Example: 2818f8e...eeb8656

  • Scopes
    These define permissions the app requests from the user. Example:

     
    user_accounts:read, pins:read, pins:read_secret, pins:write, pins:write_secret, boards:read, boards:read_secret

🔁 Callback & App Setup

  • Callback URL

     
    https://yourdomain.com/app/pinterest/board

    This must be added to your Pinterest App settings under OAuth Redirect URIs.

  • Create Pinterest App
    Register or manage your app at:
    https://developers.pinterest.com/apps/connect/


💾 Save Configuration

Click Save changes to activate and store the integration settings. Once connected, users can authenticate Pinterest accounts and post pins via Stackposts.


✅ Recommendations

  • Use Sandbox for initial testing and switch to Live for actual publishing.

  • Pinterest requires approval for certain scopes like pins:write_secret—apply for elevated access if needed.

  • Ensure all OAuth callback URLs are whitelisted in the Pinterest Developer Console.

Quick check

  • The save or publish action completes without an error.
  • The visible status, preview, or connected account matches the change.
  • If the result differs, capture the exact message and review the troubleshooting guidance before retrying.
Still need help?

Tell us where you are stuck.

Share the product, the step you reached, and any error shown. Our team can point you in the right direction.