Publishing API

X publishing API with one SocialClaw workspace.

Start the hosted X OAuth flow from the dashboard or CLI, finish consent in the browser, then reuse the connected X account through the SocialClaw workspace API key. SocialClaw supports X text posts, media posts, and reply steps inside campaign flows.

Works with Claude, ChatGPT, OpenClaw ClaudeChatGPTOpenClaw

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target X user account SocialClaw supports X text posts, media posts, and reply steps inside campaign flows.
Auth model OAuth Start the hosted X OAuth flow from the dashboard or CLI, finish consent in the browser, then reuse the connected X account through the SocialClaw workspace API key.
Media envelope X supports up to four images or one video per post. SocialClaw uploads the media to X during publish.
Inspection Validate, apply, inspect Analytics snapshots are available, and provider-native analytics fetchers are still expanding. Reconciliation currently supports X post lookup.

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 X

Start the hosted X OAuth flow from the dashboard or CLI, finish consent in the browser, then reuse the connected X account through the SocialClaw workspace API key.

03

Inspect account capabilities and settings

Read the current settings surface, including replyControl, before generating the final payload.

04

Validate before apply

Validation should happen before create-run or apply. X supports up to four images or one video per post.

05

Inspect the resulting run or post

Reconciliation currently supports X post lookup. Analytics snapshots are available, and provider-native analytics fetchers are still expanding.

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 x --open
socialclaw accounts capabilities --provider x --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

X uses the X user account route in SocialClaw. Start the hosted X OAuth flow from the dashboard or CLI, finish consent in the browser, then reuse the connected X account through the SocialClaw workspace API key.

Run the X 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