Automate with the CLI

Read JSON output

postinger accounts list --json
postinger posts list --limit 25 --json
postinger auth status --json

API commands return {data, meta}. Create and publish commands also return their idempotency key. Local authentication and diagnostic commands have their own result shapes. Errors go to stderr; --json makes them structured as well.

Exit code	Meaning
`0`	Success
`1`	API, configuration, or transport failure
`2`	Invalid command or input

Create from a file

Save a JSON body as post.json, replacing the example UUIDs with your account and media IDs:

{
  "content": "A new update",
  "targets": [{ "socialAccountId": "11111111-1111-4111-8111-111111111111" }],
  "mediaIds": ["22222222-2222-4222-8222-222222222222"]
}

postinger posts create --file post.json \
  --idempotency-key campaign-001 --json

--file - reads stdin. File input cannot be combined with individual content, account, media, or schedule flags. For edits, posts update POST_ID --file patch.json preserves omitted fields.

Retry deliberately

Reuse the same idempotency key and unchanged payload for retries of one create or publish operation, for up to 24 hours. Use a new key for each new operation. Save the key before starting a job. An uncertain upload, edit, or delete may already have succeeded. Inspect the resource before issuing another request. See retries and errors.

Command availability

The HTTP API supports before and sort on post lists. CLI 0.2.0 exposes forward pagination through --after; it does not expose --before or --sort. Use the HTTP API when you need those controls.

​Read JSON output

​Create from a file

​Retry deliberately

​Command availability

Read JSON output

Create from a file

Retry deliberately

Command availability