# Postiz

> Use the Postiz CLI to publish posts (create, schedule, upload images) to any configured integrations.

- Skill: `tools-only/postiz` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add tools-only/postiz`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/postiz/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tools-only/postiz

---


# Postiz (generic)

This skill documents how to use the Postiz CLI to manage social media posts.

It should NOT contain user-specific channel IDs, default publication rules, or language policy.

## Postiz CLI

The `postiz` binary must be available in your PATH.

Auth (required):
- `POSTIZ_API_KEY`
- `POSTIZ_BASE_URL`

### Core Workflow

Creating a post follows a one or two-step process depending on whether images are included.

#### 1. List Integrations
Find the IDs for the channels you want to post to.
```bash
postiz channels --pretty
```

#### 2. Upload Images (Optional)
If your post needs images, upload them first to get a public URL. You can repeat this for multiple images.
```bash
postiz upload-file --file-path /path/to/image.jpg --pretty
```
**Capture the `file.path`** from the JSON response. This is the URL you'll use in the next step.

#### 3. Create a Post
Create a single post or a thread.

**Draft (safe default):**
If `--status` is omitted, the post is created as draft by default.
```bash
postiz posts create --content "Your post text" --integrations <id> --pretty
```

**Single post:**
```bash
postiz posts create --content "Your post text" --integrations <id> --status now --pretty
```

**Scheduled post with image:**
```bash
postiz posts create \
  --content "Your post text" \
  --integrations <id> \
  --status scheduled \
  --scheduled-date "YYYY-MM-DDTHH:mm:ss+01:00" \
  --images "https://public-url-from-upload.png" \
  --pretty
```

**Thread / Multiple posts:**
Add multiple `--content` flags. They will be posted in order as a thread.
```bash
postiz posts create \
  --content "First tweet" \
  --content "Second tweet" \
  --integrations <id> \
  --pretty
```

### Important Formatting Note
To avoid line break issues (like literal `\n`), pass multi-line content directly to the CLI or use a subshell to read from a file:
```bash
postiz posts create --content "$(cat post.txt)" --integrations <id> --pretty
```

## Useful Commands

- `postiz posts list --start-date YYYY-MM-DD --end-date YYYY-MM-DD --pretty`: List posts in a date range.
- `postiz posts delete --id <postId> --pretty`: Delete a scheduled or draft post.