Creating Posts
The
posts create command publishes immediately by default across one or more platforms. Posts target platforms by name (one connected account per platform per workspace). Pass --draft to save without publishing or --scheduled-at to publish later.Check which platforms are connected before posting:
123akarso accounts list # or for a specific profile akarso accounts list --profile 01JXYZ...
Publish immediately
123akarso posts create \ --text "Hello world!" \ --platforms x
Publishing may still be in progress when the command returns — poll with
posts get <postId> while the status is pending or publishing.Post to multiple platforms
Pass comma-separated platform names:
123akarso posts create \ --text "Cross-platform post" \ --platforms x,linkedin,instagram
The same text is applied to every platform. See Supported Platforms for the full list of platform names.
Schedule for later
Use relative time shortcuts:
| Shortcut | Meaning |
30m | 30 minutes from now |
2h | 2 hours from now |
3d | 3 days from now |
1w | 1 week from now |
1234akarso posts create \ --text "Coming soon!" \ --platforms x \ --scheduled-at 2h
Or use an ISO 8601 timestamp:
1234akarso posts create \ --text "Launch day!" \ --platforms x \ --scheduled-at "2026-07-01T10:00:00Z"
Reschedule or cancel
Scheduled posts can be moved or cancelled before they publish:
12akarso posts reschedule post_xxx --scheduled-at 3d akarso posts cancel post_xxx
Save a draft
Pass
--draft to save without publishing. Drafts are free: they need no subscription and never count toward plan limits:1akarso posts create --text "Draft idea" --platforms x --draft
Publish a draft later (immediately or scheduled):
123akarso drafts list akarso drafts publish draft_xxx akarso drafts publish draft_xxx --scheduled-at 2h
Attach media
Pass local file paths or
https URLs directly to --media. URLs are referenced directly; local files are uploaded first. The same media applies to every platform in the post:1234akarso posts create \ --text "Check this out!" \ --media ./photo.jpg \ --platforms x
Multiple media items are comma-separated, mixing files and URLs:
1--media ./a.jpg,https://cdn.example.com/b.jpg
Supported formats: jpg, png, webp, gif images and mp4, mov videos. You can also upload a file separately with
akarso media upload <file>, which returns the public URL to reference in later posts.Pinterest pins always target a board. Pass the board ID:
123456akarso accounts pinterest-boards akarso posts create \ --text "New pin" \ --platforms pinterest \ --pinterest-board 549755885175 \ --media ./pin.jpg
Post statuses
Posts move through these statuses:
| Status | Meaning |
draft | Saved without publishing (also the state after cancelling a schedule) |
pending | Accepted, waiting to be processed |
scheduled | Waiting for its publish time |
publishing | Being published right now |
published | Published — each platform entry has the live platformPostUrl |
failed | Every platform failed — each entry has an errorMessage |
partial | Some platforms published, some failed |
List posts
1akarso posts list
Filter by status or platform:
12akarso posts list --status scheduled akarso posts list --status failed --platforms x
Delete a post
1akarso posts delete post_xxx
Add
--delete-from-platforms to also remove the published post from the social platforms themselves (where supported).Post to a different profile
Each API key targets one profile by default. Override it with
--profile to post from a different workspace:1234akarso posts create \ --text "From the other workspace" \ --platforms x \ --profile 01JXYZ...
Use
akarso profiles list to see available profile IDs. The profile must be in the same org as your API key.Output format
All commands output YAML by default. Use
--json for raw JSON:1akarso posts list --json | jq '.posts[0].postId'
Or pipe YAML through
yq:1akarso posts list | yq '.posts[0].status'