CLI quickstart - Postinger

Install

Requires Node.js 24.15.0 or newer. These instructions cover CLI 0.2.0, available on npm.

npm install -g @postinger/cli@0.2.0
postinger --version

Connect a project

postinger auth login
postinger auth status

The CLI opens your browser and prints a matching code. Sign in as a project admin, verify the code, select a project, and approve the connection. Use --no-browser to print the link instead.

Check your account

postinger accounts list
postinger accounts capabilities ACCOUNT_ID

The capability response includes connection availability, caption and attachment limits, and platform options. supported: true alone does not mean the account is available.

Upload and draft

postinger upload ./photo.jpg
postinger posts create \
  --content "A new update" \
  --account ACCOUNT_ID \
  --media MEDIA_ID \
  --idempotency-key launch-draft-001

Replace MEDIA_ID with the ready media ID returned by upload. The post stays a draft unless you supply --scheduled-at.

Publish and verify

postinger posts publish POST_ID --yes --idempotency-key launch-publish-001
postinger posts get POST_ID

Publishing requires posts-publish. Success from the publish command means the request was accepted. Check the post until it reaches a final status; inspect individual targets for failures. For connection problems, run postinger doctor. See authentication and all commands.