> ## Documentation Index
> Fetch the complete documentation index at: https://tryunsora.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Social posting

> Schedule and publish posts to YouTube, TikTok, Instagram, Facebook, and more straight from the terminal with the Unsora CLI.

Schedule or publish posts to any connected account on **YouTube, TikTok,
Instagram, Facebook, LinkedIn, Bluesky, Threads, or Pinterest**. Connect
accounts in the [web app](https://app.tryunsora.com); posting requires a paid
plan.

## See your accounts

```bash theme={null}
unsora accounts
unsora accounts --platform tiktok
```

Copy the account `id` values — they're what `post create` targets. YouTube
accounts show provider `google`.

## Create & schedule posts

```bash theme={null}
# Post a video now
unsora post create -c "caption" -a <account-id> --video https://...

# Schedule a slideshow to two accounts
unsora post create -c "caption" -a <id1> -a <id2> \
  --image https://.../1.jpg --image https://.../2.jpg \
  --schedule 2026-08-05T10:00:00Z --timezone Europe/London
```

`--schedule` must be at least 2 minutes in the future; omit it to publish
immediately. Media URLs can come from generations or
[`unsora upload`](/docs/cli/uploads).

## Platform extras

```bash theme={null}
# YouTube: title, privacy, tags
unsora post create -c "description text" -a <youtube-account-id> \
  --video https://... --title "Video title" --privacy unlisted \
  --tag ai --tag shorts

# Pinterest: pin title + board
unsora post create -c "caption" -a <pinterest-account-id> \
  --image https://... --title "Pin title" --board <board-id>
```

<Note>
  Instagram feed/slideshow images must be between **4:5 and 1.91:1** — 9:16
  images are rejected (use 9:16 only for Reels video and TikTok). See the
  [Create Post reference](/docs/api-reference/posts/create_post) for all media rules.
</Note>

## Manage posts

```bash theme={null}
unsora post list --status SCHEDULED
unsora post get <id>                 # per-account publish status + URLs
unsora post update <id> --schedule 2026-08-06T09:00:00Z
unsora post update <id> --unschedule # back to draft
unsora post retry <id>               # re-attempts only failed accounts
unsora post delete <id>
```

`retry` is safe: it only re-attempts accounts that failed and never
double-posts to accounts that already published.
