SocialClaw
Publishing API

Instagram Standalone publishing API with one SocialClaw workspace.

Connect a standalone professional Instagram account through Instagram Login, then reuse that target from the same hosted SocialClaw workspace. SocialClaw publishes image and reel steps for standalone Instagram professional accounts.

Account type Standalone professional account Instagram standalone posts require one image or one video per step.
Best fit AI agents This route is separate from Instagram Business and is not for personal consumer accounts.

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target Standalone professional account SocialClaw publishes image and reel steps for standalone Instagram professional accounts.
Auth model OAuth Connect a standalone professional Instagram account through Instagram Login, then reuse that target from the same hosted SocialClaw workspace.
Media envelope Instagram standalone posts require one image or one video per step. Instagram pulls a public media URL, including SocialClaw-hosted media URLs.
Inspection Validate, apply, inspect Analytics snapshots are available, but Instagram provider-native analytics fetchers are not implemented yet. Instagram standalone reconciliation is not implemented yet.

What the payload needs

The main fields and constraints to account for.

  • Standalone professional account stored in the SocialClaw workspace
  • Instagram standalone posts require one image or one video per step.
  • Provider-specific settings such as instagramPublishMode
  • Workspace API key auth and post or run inspection after apply

How the workflow runs

Connect the account, validate the post, then publish.

Step 1

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.

Step 2

Connect Instagram Standalone

Connect a standalone professional Instagram account through Instagram Login, then reuse that target from the same hosted SocialClaw workspace.

Step 3

Inspect account capabilities and settings

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

Step 4

Validate before apply

Validation should happen before create-run or apply. Instagram standalone posts require one image or one video per step.

Step 5

Inspect the resulting run or post

Instagram standalone reconciliation is not implemented yet. Analytics snapshots are available, but Instagram provider-native analytics fetchers are not implemented yet.

CLI and HTTP examples

Example commands and requests for this route.

CLI flow Instagram Standalone publishing API
socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts connect --provider instagram --open
socialclaw accounts capabilities --provider instagram --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
HTTP API flow Hosted SocialClaw endpoints
curl -sS \
  -H "Authorization: Bearer $SC_API_KEY" \
  "https://getsocialclaw.com/v1/keys/validate"

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

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

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

Current limitations

A few practical limits to keep in mind.

  • This route is separate from Instagram Business and is not for personal consumer accounts.
  • Media is required for every post.
  • Stories, carousels, text-only posts, and reply or comment steps are not implemented in the current flow.

Related routes

Related integrations and use cases.

Frequently asked questions

What account type does the Instagram Standalone publishing API route use?

Instagram Standalone uses the Standalone professional account route in SocialClaw. Connect a standalone professional Instagram account through Instagram Login, then reuse that target from the same hosted SocialClaw workspace.

What media rules apply to the Instagram Standalone publishing API route?

Instagram standalone posts require one image or one video per step. Instagram pulls a public media URL, including SocialClaw-hosted media URLs.

What should the workflow inspect before applying Instagram Standalone posts?

Inspect settings such as instagramPublishMode and capabilities. This route is separate from Instagram Business and is not for personal consumer accounts.

Run the Instagram Standalone publishing API workflow in SocialClaw

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