Skip to content
Docs

Guide

Create Pins without a second publishing stack.

platform: pinterest

Publish image and video Pins with titles, destination links, boards and board sections. Read Pin and account analytics next to the rest of your channels.

Connect

Sign in with Pinterest (OAuth). Socialit refreshes tokens in the background.

Use the hosted or headless flow described in Connecting accounts. Once connected, the account appears in GET /v1/accounts?platform=pinterest.

Publish

Post typeLimits and notes
PinsImage or video Pins with title, link and board
Images–
Video–
POST /v1/posts
curl https://api.socialit.com/v1/posts \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Focus mode is live. Open one account, use everything.",
    "account_ids": [
      "sa_pinterest…"
    ],
    "media_ids": [
      "med_7Hk2…"
    ],
    "scheduled_at": "2026-10-14T09:00:00.000Z",
    "platform_options": {
      "pinterest": {
        "board_id": "brd_…",
        "title": "Focus mode in 60 seconds",
        "link": "https://socialit.com/"
      }
    }
  }'

Network-specific options go under platform_options.pinterest (schemas: GET /v1/posts/platform-options). Socialit validates them before publishing and returns 422 with per-field errors otherwise.

Capabilities

PublishingYes
Direct messagesNo
CommentsNo
ReviewsNo
MentionsNo
AnalyticsPost and account metrics
Edit after publishingNo
Delete or unpublishYes
First commentNo
AdsPinterest Ads

Focus mode

In Focus mode a Pinterest account exposes:

  • Boards and board sections
  • Pins with links, alt text and covers
  • Pin and account analytics
  • Pinterest Ads campaigns

Each resource is also available at /v1/accounts/{id}/focus/{resource}.