Publishing API

Pinterest publishing API with one SocialClaw workspace.

Start the standard Pinterest OAuth flow from SocialClaw, then inspect board-scoped capabilities and discovery actions from the connected account in the same workspace. SocialClaw supports standard pins, video pins, and multi-image pins for board-centric Pinterest publishing.

Works with Claude, ChatGPT, OpenClaw ClaudeChatGPTOpenClaw

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target Board-centric Pinterest target SocialClaw supports standard pins, video pins, and multi-image pins for board-centric Pinterest publishing.
Auth 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 envelope 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.
Inspection Validate, apply, inspect Pin analytics and account analytics are supported through the standard analytics commands after the board target is connected. Pinterest-specific reconciliation is not advertised as a current first-party capability.

What the payload needs

The main fields and constraints to account for.

How the workflow runs

Connect the account, validate the post, then publish.

01

Authenticate the workspace

Use the workspace API key with the CLI or hosted HTTP API so the publishing workflow stays attached to the same customer workspace.

02

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.

03

Inspect account capabilities and settings

Read the current settings surface, including pinMode, link, altText, boardSectionId, coverImageUrl, coverImageKeyFrameTime, before generating the final payload.

04

Validate before apply

Validation should happen before create-run or apply. Pinterest supports one video or up to five image assets per pin.

05

Inspect the resulting run or post

Pinterest-specific reconciliation is not advertised as a current first-party capability. Pin analytics and account analytics are supported through the standard analytics commands after the board target is connected.

CLI and HTTP examples

Example commands and requests for this route.

socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts connect --provider pinterest --open
socialclaw accounts capabilities --provider pinterest --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --idempotency-key launch_1 --json
socialclaw runs inspect --run-id <run-id> --json

Current limitations

A few practical limits to keep in mind.

Related routes

Related integrations and use cases.

What builders are saying

Real quotes from Reddit, G2, Trustpilot, and Instagram.

Works with every major platform

Connect once, then schedule and publish everywhere from the same workspace.

Frequently Asked Questions

Pinterest uses the Board-centric Pinterest target route in SocialClaw. Start the standard Pinterest OAuth flow from SocialClaw, then inspect board-scoped capabilities and discovery actions from the connected account in the same workspace.

Run the Pinterest publishing API workflow in SocialClaw

Connect the account once, validate before publish, and keep everything in one workspace.

Supported social platforms
Schedule to social media Works with Claude ChatGPT Codex OpenClaw
Start free