CLI & SDKs

The Schedulala CLI is the fastest way to interact with the API. Install it once and schedule posts, manage accounts, and check usage from your terminal or CI pipeline. Zero runtime dependencies. Prefer other tooling? The full API is described in an OpenAPI 3.1 document at https://schedulala.com/developers/openapi.json, ready to import into ChatGPT custom GPT Actions, Postman, or client generators.

Installation

Requires Node.js 18+ (uses built-in fetch).

npm install -g schedulala

Authentication

Run schedulala init to start a device authorization flow. You'll receive a verification code to enter at schedulala.com, and your API key is saved to ~/.schedulala/config.json.

# Interactive device auth (recommended)
schedulala init --email you@example.com

# Or set an API key directly
export SCHEDULALA_API_KEY=sk_live_...

# Or pass per-command
schedulala whoami --api-key sk_live_abc123

Priority: --api-key flag > SCHEDULALA_API_KEY env > config file.

Commands

Posts

# Create a post (publish immediately)
schedulala post "Hello world!" --platforms twitter --now

# Schedule a post
schedulala post "Scheduled post" --platforms twitter,linkedin --schedule "2026-06-15T10:00:00Z"

# Save as draft
schedulala post "Draft idea" --platforms instagram --draft

# Add to auto-scheduling queue
schedulala post "Queued post" --platforms twitter --queue

# With media
schedulala post "Check this out" --platforms instagram --media "https://example.com/photo.jpg" --now

# Platform-specific content
schedulala post "Default text" --platforms twitter,linkedin \
  --platform-content '{"twitter":{"content":"Tweet version"},"linkedin":{"content":"LinkedIn version"}}' \
  --now

# Platform-specific settings (e.g. Mastodon visibility / content warnings)
schedulala post "Fediverse post" --platforms mastodon \
  --platform-settings '{"mastodon":{"visibility":"unlisted"}}' \
  --now

# List posts
schedulala post:list --status posted --limit 10

# Get post status
schedulala post:status <id>

# Watch until published/failed
schedulala post:status <id> --watch

# Delete a post
schedulala post:delete <id>

# Retry a failed post
schedulala post:retry <id>

Accounts

# List connected accounts
schedulala accounts

# Filter by platform
schedulala accounts --platform twitter

# Health check all accounts
schedulala accounts:health

# Get OAuth URL to connect a new account
schedulala connect twitter --brand-id <id>

Info

# Show current user and plan
schedulala whoami

# Show API usage and limits
schedulala usage

Configuration

# Set a config value
schedulala config set api_key sk_live_abc123

# Get a config value
schedulala config get api_key

# List all config
schedulala config list

# Show config file path
schedulala config path

JSON output (for scripts & AI agents)

Every command supports --json for structured output. In JSON mode, success data goes to stdout as JSON, no human-readable text is printed, and errors are structured as {"error":{"message":"...","code":N}}.

# Returns JSON to stdout, no human formatting
schedulala post:list --json

# Pipe to jq
POST_ID=$(schedulala post "Hello!" --platforms twitter --now --json | jq -r '.post.id // .post._id')

# Watch until published
schedulala post:status $POST_ID --watch --json

Agent Skill (Claude Code, Codex & more)

The open-source Schedulala Agent Skill teaches AI coding agents the full workflow — the draft → preview → confirm → publish loop, media handling, and every per-platform rule — so they use the CLI and MCP tools correctly on the first try.

npx skills add schedulala/schedulala-agent

Global flags

Flag	Description
--json	Output JSON (for scripts/agents)
--api-key <key>	Override API key for this command
--base-url <url>	Override API base URL
--verbose	Show request/response details
--help, -h	Show help
--version, -V	Show version

REST API

Prefer raw HTTP? Every CLI command maps to a REST endpoint. You can use fetch, axios, requests, or cURL with the base URL https://schedulala.com/api/v1. See the Quickstart and Posts API for endpoint examples with cURL, Node.js, and Python code samples.

Supported platforms

Twitter, Instagram, Facebook, LinkedIn, TikTok, Threads, Bluesky, YouTube, Pinterest, Telegram, and Mastodon.

Next Steps

Quickstart — End-to-end walkthrough of creating your first post Posts API — Full endpoint reference for posts Webhooks — Set up real-time event notifications