akarso posts create
Create a social media post as a draft, publish it immediately, or schedule it for later.
Three modes:
- No timing flag: publishes immediately to all selected platforms
--draft: saves a draft (stored by Akarso, publish later withdrafts publish)--scheduled-at: schedules for a future time (accepts ISO dates like2026-03-15T14:00:00Z, or relative values:30m,2h,3d,1w)
The same text and media are applied to every selected platform. Platforms are specified as a comma-separated list (e.g.
--platforms x,linkedin,instagram). Run accounts list to see which platforms are connected in the current profile.Media: attach images or videos with
--media. Accepts local file paths and https URLs, comma-separated. URLs are referenced directly; local files are uploaded first. Supported formats: jpg, png, webp, gif, mp4, mov.Pinterest: requires
--pinterest-board <boardId>. List board IDs with accounts pinterest-boards.Publishing requires an active subscription. Returns 402 if no subscription exists (run
akarso subscribe to start a free trial) and 403 if the org has hit its plan's monthly post limit or account limit. Drafts are free.Usage
1akarso posts create
Options
| Option | Default | Description |
--text <content> | - | Post text content, applied to every platform |
--platforms <list> | - | Comma-separated platforms to publish to (x, twitter, instagram, facebook, linkedin, tiktok, youtube, threads, pinterest, bluesky, googlebusiness) |
--draft | - | Save as a draft instead of publishing |
--scheduled-at [iso] | - | Schedule time: ISO date, 30m, 2h, 3d, or 1w |
--media [items] | - | Comma-separated media items: local file paths or https URLs. URLs are referenced directly; local files are uploaded (not available on the hosted MCP server, use URLs there). |
--pinterest-board [id] | - | Pinterest board ID to pin to (required when posting to pinterest) |
Global Options
| Option | Default | Description |
--api-key [key] | - | API key (overrides AKARSO_API_KEY env and ~/.akarso/config.json) |
--api-url [url] | - | Server URL (overrides AKARSO_API_URL env, defaults to akarso.co) |
--profile [id] | - | Profile (workspace) ID to operate on, overriding the API key's pinned profile. Use profiles list to see available IDs. |
--json | - | Output raw JSON instead of YAML |
-h, --help | - | Display this message |
-v, --version | - | Display version number |
Examples
1akarso posts create --text "Hello!" --platforms x
1akarso posts create --text "Later" --platforms x,linkedin --scheduled-at 2h
1akarso posts create --text "Idea" --platforms x --draft
1akarso posts create --text "Pics" --platforms instagram --media ./photo.jpg,https://example.com/clip.mp4