SocialClaw
GitHub Dashboard
OAuth integration

Manage board-centric Pinterest publishing through SocialClaw.

SocialClaw keeps Pinterest connection, board discovery, media handoff, validation, and pin scheduling under one hosted workspace instead of splitting them across separate schedulers and scripts.

Start free View pricing
Media Pinterest supports one video or up to five image assets per pin. Pinterest fetches image URLs, while SocialClaw uploads video when the pin mode requires it.
Publishing SocialClaw supports standard pins, video pins, and multi-image pins for board-centric Pinterest publishing. Pinterest is board-centric in SocialClaw today.

What this integration supports

The main details for this connection.

Account type Board-centric Pinterest target Start the standard Pinterest OAuth flow from SocialClaw, then inspect board-scoped capabilities and discovery actions from the connected account in the same workspace.
Auth model OAuth The hosted SocialClaw OAuth flow stores the connection in the workspace.
Scheduling Validate, draft, apply, inspect SocialClaw supports standard pins, video pins, and multi-image pins for board-centric Pinterest publishing. Pinterest-specific reconciliation is not advertised as a current first-party capability.
Analytics Snapshots and health Pin analytics and account analytics are supported through the standard analytics commands after the board target is connected.

Connection, media, and delivery

How accounts connect, what media works, and how publishing behaves.

Connection model OAuth Start the standard Pinterest OAuth flow from SocialClaw, then inspect board-scoped capabilities and discovery actions from the connected account in the same workspace.
Media and delivery Pinterest supports one video or up to five image assets per pin. Pinterest fetches image URLs, while SocialClaw uploads video when the pin mode requires it.

Settings and discovery

Useful settings and discovery notes for this provider.

Current settings surface

  • pinMode
  • link
  • altText
  • boardSectionId
  • coverImageUrl
  • coverImageKeyFrameTime

Discovery notes

  • Pinterest discovery actions expose boards, sections, and connected catalogs before the agent promises a publish surface.

CLI and HTTP examples

Example commands and requests for this integration.

CLI flow Workspace API key + provider connect 
socialclaw login
socialclaw accounts connect --provider pinterest --open
socialclaw accounts capabilities --provider pinterest --json
socialclaw validate -f schedule.json --json
HTTP API flow Hosted SocialClaw endpoints 
curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pinterest"}' \
  "https://getsocialclaw.com/v1/connections/start"

curl -sS \
  -H "Authorization: Bearer $SC_API_KEY" \
  "https://getsocialclaw.com/v1/accounts"

Current limitations

A few practical limits to keep in mind.

  • Pinterest is board-centric in SocialClaw today.
  • Product, collection, and idea surfaces should be treated as capability-gated or beta rather than assumed for every workspace.
  • Product pin mode is not available in the generic publish flow without the required Pinterest capability.

Related routes

Related use cases and workflows.

Hub
All integrations Provider and account-type routes
Hub
Use cases Audience and workflow-fit routes
Hub
Workflows Capability and route-level workflow pages
Product
Pricing Trial and plan details
Product
AI agents overview Main SocialClaw page for AI-agent publishing
Product
Scheduler Hosted scheduling overview
Use case
Embedded SaaS Use SocialClaw as the hosted social publishing layer inside another SaaS product while customer account connections stay in one workspace.
Publishing API
Pinterest publishing API Use the SocialClaw workspace API and CLI to connect Pinterest, validate schedules, upload media when needed, and inspect publish state.
Integration
WordPress SocialClaw keeps WordPress site connection, remote media upload, publish settings, validation, and post inspection in one hosted workspace shared by the dashboard, API, CLI, and agent workflows.
Integration
Instagram Business SocialClaw keeps account connection, hosted media URLs, schedule validation, and Instagram Business publish execution in the same workspace used by your dashboard, API, CLI, or agent workflow.

Frequently asked questions

How does SocialClaw connect Pinterest?

Start the standard Pinterest OAuth flow from SocialClaw, then inspect board-scoped capabilities and discovery actions from the connected account in the same workspace. The connection is stored in the workspace so scripts, agents, and the dashboard reuse the same account state.

What can I publish to Pinterest with SocialClaw?

SocialClaw supports standard pins, video pins, and multi-image pins for board-centric Pinterest publishing. Pinterest supports one video or up to five image assets per pin. Pinterest fetches image URLs, while SocialClaw uploads video when the pin mode requires it.

What should I check before scheduling Pinterest posts?

Inspect publish settings such as pinMode, link, altText, boardSectionId, coverImageUrl, coverImageKeyFrameTime. Pinterest is board-centric in SocialClaw today.

Use Pinterest through one hosted SocialClaw workspace

Connect the account once, validate before apply, and keep post plus run inspection in the same workspace used by the dashboard, API, and CLI.

Start free View pricing