Quickstart

From zero to a scheduled post in a few minutes.

1. Create a Socioi account

2. Create an API key

Open Settings → Developers → Access
Click Generate key
Copy the si_live_… value immediately (shown once)

3. List your channels

curl -H "Authorization: si_live_YOUR_KEY" \
  https://socioi.com/api/public/v1/channels

Copy a channel id from the response.

4. Schedule a post

curl -X POST "https://socioi.com/api/public/v1/posts" \
  -H "Authorization: si_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-09-20T10:00:00.000Z",
    "content": "Hello from the Socioi API",
    "channelIds": ["CHANNEL_ID"]
  }'

The worker picks up SCHEDULED posts when date is due.

5. (Optional) Attach media

curl -X POST "https://socioi.com/api/public/v1/media/upload-from-url" \
  -H "Authorization: si_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/photo.jpg"}'

Pass the returned media id in mediaIds on create.

Building for other users?

Use OAuth apps instead of sharing API keys.

Prefer an AI client?

MCP — Claude, ChatGPT, or Cursor call tools over HTTPS (no shell required).
AI Agents CLI — Claude Code / OpenClaw run socioi commands and parse JSON stdout.

Same workspace and API key as the Public API.