Schedule content

Schedule image posts on X with native upload and validation before apply.

SocialClaw supports X text posts plus native media upload. For image-specific routes, the current limit is up to four images per post, with reply-step support handled inside campaign flows.

Try the CLI Open dashboard

Account type X user account Up to four images per post

Best fit AI agents X supports up to four images or one video per post, not both together.

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target X user account The workflow uses a connected X account inside the SocialClaw workspace.

Media rule Up to four images per post SocialClaw uploads the supplied images natively to X during publish.

Settings replyControl The route can inspect replyControl before apply when X reply visibility matters.

Campaign support Reply steps are supported Reply logic is provider-specific and works through explicit X campaign reply steps.

What the payload needs

The main fields and constraints to account for.

x:@handle target in the workspace
One to four image assets
Optional replyControl setting
Validation before apply and run inspection after publish

How the workflow runs

Connect the account, validate the post, then publish.

Step 1

Connect the X account

Start the hosted X OAuth flow and keep the connected X user account in the SocialClaw workspace.

Step 2

Prepare the image assets

Use up to four images for the X post. SocialClaw uploads those images natively during publish.

Step 3

Validate the post shape

Validation confirms the one-post image envelope, replyControl, and any provider-specific limits before apply.

Step 4

Apply and inspect

Create the scheduled X post, then inspect run or post state after publish.

CLI and HTTP examples

Example commands and requests for this route.

CLI flow Schedule images on X

socialclaw accounts connect --provider x --open
socialclaw validate -f x-image-schedule.json --json
socialclaw apply -f x-image-schedule.json --idempotency-key x_images_1 --json
socialclaw posts reconcile --post-id <post-id> --json

HTTP API flow Hosted SocialClaw endpoints

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"x"}' \
  "https://getsocialclaw.com/v1/connections/start"

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d @x-image-schedule.json \
  "https://getsocialclaw.com/v1/posts/validate"

Current limitations

A few practical limits to keep in mind.

X supports up to four images or one video per post, not both together.
Comment publishing is not supported.
Reply logic is implemented for X campaign reply steps rather than as a universal interaction model.