Audience workflow

Use SocialClaw as a Discord scheduler for AI-agent status and alert workflows.

SocialClaw fits AI-agent Discord workflows because the workspace stores the webhook target, enforces the one-asset limit, and exposes validation and publish inspection through the same API key the agent already uses.

Try the CLI Open dashboard

Account type Discord webhook target Text-only, text plus one image, or text plus one video

Best fit AI agents Discord does not use OAuth in SocialClaw.

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Agent fit Workspace-held webhook target The webhook target stays in the SocialClaw workspace so the agent does not need to re-enter it for each run.

Media rule One optional asset The route supports text-only or text plus one image or one video.

Delivery Direct webhook upload SocialClaw fetches the media URL and uploads it to the webhook during publish.

Inspection Validate before apply The agent can confirm that the stored webhook is still publishable before scheduling the alert or status post.

What the payload needs

The main fields and constraints to account for.

Workspace API key auth
Stored Discord webhook target
Message text with zero or one asset
Validation before apply

How the workflow runs

Connect the account, validate the post, then publish.

Step 1

Store the Discord webhook in the workspace

Connect the Discord webhook once so the agent can reuse the stored target.

Step 2

Generate message text and one optional asset

The agent can emit a text-only message or a message with one image or one video.

Step 3

Validate the webhook route

Capabilities and validation confirm the stored target and the one-asset Discord limit before apply.

Step 4

Apply and inspect the result

Create the scheduled Discord post and inspect the resulting run or post state afterward.

CLI and HTTP examples

Example commands and requests for this route.

CLI flow Discord scheduler for AI agents

socialclaw login --api-key <workspace-key>
socialclaw accounts connect --provider discord --webhook-url <discord-webhook-url> --json
socialclaw validate -f discord-agent-schedule.json --json
socialclaw apply -f discord-agent-schedule.json --idempotency-key discord_agent_1 --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":"discord","webhookUrl":"<discord-webhook-url>"}' \
  "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"