Configurations

Pinterest

Pinterest is supported in Outstand through the Bring Your Own Key (BYOK) model. This allows you to use your own Pinterest API credentials to connect your Pinterest accounts and publish pins through Outstand's unified social media API.

Prerequisites

Before configuring Pinterest integration, you need:

1. A Pinterest Business account
2. Access to Pinterest's Developer Portal
3. A registered Pinterest API application with approval for the Content Publishing API
4. Your application's App ID (client key) and App Secret (client secret)

Required Scopes

When setting up your Pinterest application, ensure the following OAuth scopes are enabled:

Scope	Purpose
pins:read	Read pin data and analytics
pins:write	Create and manage pins
boards:read	List available boards
boards:write	Create and manage boards
user_accounts:read	Access user profile information

Setup

Step 1: Register Your Pinterest API Credentials

curl -X POST  \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "pinterest",
    "client_key": "YOUR_PINTEREST_APP_ID",
    "client_secret": "YOUR_PINTEREST_APP_SECRET"
  }'

Step 2: Connect a Pinterest Account

Direct your users to the OAuth initiation endpoint:

GET

Optional query parameters:

• redirect_uri - Custom redirect URI after OAuth completes (for white-label flows)
• tenant_id - Tenant identifier for multi-tenant applications

Step 3: Discover Available Boards

After connecting an account, list the user's boards to find available board_id values:

curl  \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "success": true,
  "data": [\
    {\
      "id": "123456789",\
      "name": "Summer Collection",\
      "description": "Our summer products",\
      "pin_count": 42,\
      "privacy": "PUBLIC"\
    }\
  ]
}

Creating Pinterest Posts

Pinterest requires a board_id for every pin. Pass it in the pinterest configuration when creating a post:

curl -X POST  \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Check out our latest summer collection!",
    "accounts": ["pinterest"],
    "containers": [\
      {\
        "content": "Beautiful summer dresses now available",\
        "media": [\
          {\
            "url": "
            "filename": "dress.jpg"\
          }\
        ]\
      }\
    ],
    "pinterest": {
      "board_id": "123456789",
      "title": "Summer Dresses 2026",
      "link": "
      "alt_text": "A model wearing a red summer dress"
    }
  }'

Pinterest Configuration Fields

Field	Required	Description
board_id	Yes	The ID of the Pinterest board to pin to
title	No	Pin title (max 100 characters). Defaults to first 100 chars of content
link	No	Destination URL when the pin is clicked
alt_text	No	Accessibility text for images (max 500 characters)

Supported Features

Feature	Supported	Notes
Single image pin	Yes	Pass one image in media
Multi-image pin (carousel)	Yes	Pass multiple images in media
Video pin	Yes	Pass video URL in media; uploaded and processed async
Pin analytics	Yes	Impressions, saves, clicks, outbound clicks (90-day window)
Account analytics	Yes	User account-level analytics with date range
Comments/replies	No	Pinterest API v5 does not expose a comments endpoint
Repost/repin	No	Not available via API

Media Requirements

• Images: Must be publicly accessible HTTPS URLs. Pinterest fetches images from the URL directly (no upload step needed).
• Videos: Uploaded to Pinterest via their async media processing pipeline. Pinterest processes the video before the pin is created.
• At least one image or video is required for every Pinterest pin. Text-only pins are not supported.

Token Management

Pinterest access tokens expire after 30 days. Outstand automatically refreshes tokens using the refresh token (valid for 1 year). The token refresher worker handles this automatically.

Limitations

• Every pin must be assigned to a board (board_id is required)
• Pinterest does not have a comments/replies API
• Reposting/repinning is not available via the API
• Pin descriptions are limited to 800 characters
• Pin titles are limited to 100 characters

LinkedIn\ \ Previous Page Threads\ \ Next Page

On this page

Prerequisites Required Scopes Setup Step 1: Register Your Pinterest API Credentials Step 2: Connect a Pinterest Account Step 3: Discover Available Boards Creating Pinterest Posts Pinterest Configuration Fields Supported Features Media Requirements Token Management Limitations