Postonus

Getting started

Create a workspace, connect a channel, and schedule your first post.

Last updated on

Sign up at postonus.com. Signing up creates a workspace for you automatically — there is no separate "create a workspace" step, and no card is required.

What you get before you pay

A new workspace is a Free workspace. It can:

  • Connect up to 3 channels.
  • Write posts and hold up to 30 drafts, including drafts with a date on the calendar.
  • Upload media, up to 1GB.

It cannot create a live schedule or publish anything. Add a card to unlock scheduling and publishing — nothing else about the workspace changes, and no draft is lost while you decide.

Connect a channel

From the dashboard, open Integrations and connect a platform. From the CLI:

postonus channels connect

This opens the platform's OAuth screen in your browser and waits for the channel to appear. See CLI install if you have not set up the CLI yet.

Two platforms — Bluesky and Telegram — connect with a credential (an app password or a bot token) instead of OAuth, from the dashboard's Integrations page.

Schedule your first post

Once a channel is connected and your workspace can schedule, pick a surface:

# CLI
postonus post "Shipped it." --to linkedin --optimal
# API
curl -X POST https://app.postonus.com/api/v1/posts \
  -H "x-api-key: $POSTONUS_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "rows": [{ "content": "Shipped it." }],
    "shared": { "selectedIntegrations": ["<integration-id>"] },
    "postAction": "NEXT_WINDOW"
  }'

Or ask an assistant connected over MCP to do it — see Connecting an assistant.

None of these publish immediately. NEXT_WINDOW stages the post for the next recommended time; pass SCHEDULED_TIME with an explicit time, or DRAFT to hold it with no schedule yet. See the API quickstart for the full request and response.

Where to go next

You want to…Read
Script posts from your own code or CIAPI
Let Claude, Cursor, or ChatGPT manage your queueMCP
Post and check your queue from a terminalCLI

On this page