Publishing API

Instagram Business publishing API with one SocialClaw workspace.

Connect a professional or business Instagram account that is linked to a Facebook Page through the SocialClaw OAuth flow, then reuse that target from the same workspace. SocialClaw publishes image and reel steps for Instagram Business targets linked to a Facebook Page.

Try the CLI Open dashboard

Account type Page-linked professional or business account Instagram Business requires one image or one video per post and does not support text-only posts in the current flow.

Best fit Embedded SaaS The target must be a professional or business Instagram account linked to a Facebook Page.

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target Page-linked professional or business account SocialClaw publishes image and reel steps for Instagram Business targets linked to a Facebook Page.

Auth model OAuth Connect a professional or business Instagram account that is linked to a Facebook Page through the SocialClaw OAuth flow, then reuse that target from the same workspace.

Media envelope Instagram Business requires one image or one video per post and does not support text-only posts in the current flow. The provider 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 Business reconciliation is not implemented yet.

What the payload needs

The main fields and constraints to account for.

Page-linked professional or business account stored in the SocialClaw workspace
Instagram Business requires one image or one video per post and does not support text-only posts in the current flow.
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 Business

Connect a professional or business Instagram account that is linked to a Facebook Page through the SocialClaw OAuth flow, then reuse that target from the same 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 Business requires one image or one video per post and does not support text-only posts in the current flow.

Step 5

Inspect the resulting run or post

Instagram Business 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 Business publishing API

socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts connect --provider instagram_business --open
socialclaw accounts capabilities --provider instagram_business --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_business"}' \
  "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.

The target must be a professional or business Instagram account linked to a Facebook Page.
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.

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.

Use case

Embedded SaaS Use SocialClaw as the hosted social publishing layer inside another SaaS product while customer account connections stay in one workspace.

Product

Pricing Trial and plan details for CLI or API execution

Product

AI agents overview Main SocialClaw page for AI-agent publishing

Frequently asked questions

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

Instagram Business uses the Page-linked professional or business account route in SocialClaw. Connect a professional or business Instagram account that is linked to a Facebook Page through the SocialClaw OAuth flow, then reuse that target from the same workspace.

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

Instagram Business requires one image or one video per post and does not support text-only posts in the current flow. The provider pulls a public media URL, including SocialClaw-hosted media URLs.

What should the workflow inspect before applying Instagram Business posts?

Inspect settings such as instagramPublishMode and capabilities. The target must be a professional or business Instagram account linked to a Facebook Page.

Run the Instagram Business publishing API workflow in SocialClaw

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

Try the CLI Open dashboard