Quickstart

Schedule your first social media post in under 5 minutes.

1. Get your API key

Get an API key directly from the terminal — no browser sign-up required:

# Install the CLI
npm install -g schedulala

# Authenticate with device flow (opens browser)
schedulala init --email you@example.com

Alternatively, sign up at schedulala.com and go to Settings → Developer API. See the Authentication page for all options.

schedulala init gives you a free API key right away (2 accounts, 4 posts to try it out, no card). Run schedulala upgrade when you need more accounts, more posts, or X.

2. Connect a social account

Connect the social accounts you want to post to:

# OAuth platforms (opens browser)
schedulala connect instagram
schedulala connect linkedin

# Credential platforms (prompts interactively)
schedulala connect bluesky
schedulala connect telegram

See the Connecting Accounts page for details on each platform.

3. Make your first request

Test your API key by listing your connected accounts:

# Verify authentication
schedulala whoami

# List connected accounts
schedulala accounts

4. Create a post

Schedule a post to one or more platforms. Replace the accountId with a real account ID from the previous step.

schedulala post "Hello from the Schedulala API!" --platforms bluesky --now

See the CLI & SDKs page for all available commands.

5. Check post status

Use the post ID from the response to check its status:

schedulala post:status <post-id>

# Watch until posted or failed
schedulala post:status <post-id> --watch

In sandbox mode, posts resolve immediately to posted status with simulated postIds — no delay or intermediate states.

6. Next steps