Schedule and manage social media posts via Postiz API (self-hosted or cloud).
Direct API integration — no n8n dependency.
Supports X/Twitter, LinkedIn, Bluesky with platform-specific character limits.
Includes deduplication, scheduling, media upload, and thread creation.
WHAT IT CAN DO:
- Schedule posts to 28+ channels (X, LinkedIn, Bluesky, Reddit, Instagram, Facebook, Threads, YouTube, TikTok, Pinterest, Mastodon, and more)
- Multi-platform posting in a single API call with platform-adapted content
- X/Twitter thread creation for longer content
- Media upload (file and URL)
- Find next available posting slot per channel
- List, query, update, and delete scheduled posts
- Deduplication workflow (check existing before posting)
- Platform-specific character limits and content tone guidance
- Post state management (QUEUE, PUBLISHED, ERROR, DRAFT)
- Helper script for quick posting with auto-validation
USE WHEN: scheduling social media posts, creating multi-platform content, managing a posting ca
Schedule and manage social media posts via Postiz API (self-hosted or cloud).
Direct API integration — no n8n dependency.
Supports X/Twitter, LinkedIn, Bluesky with platform-specific character limits.
Includes deduplication, scheduling, media upload, and thread creation.
WHAT IT CAN DO:
- Schedule posts to 28+ channels (X, LinkedIn, Bluesky, Reddit, Instagram, Facebook, Threads, YouTube, TikTok, Pinterest, Mastodon, and more)
- Multi-platform posting in a single API call with platform-adapted content
- X/Twitter thread creation for longer content
- Media upload (file and URL)
- Find next available posting slot per channel
- List, query, update, and delete scheduled posts
- Deduplication workflow (check existing before posting)
- Platform-specific character limits and content tone guidance
- Post state management (QUEUE, PUBLISHED, ERROR, DRAFT)
- Helper script for quick posting with auto-validation
USE WHEN: scheduling social media posts, creating multi-platform content, managing a posting calendar, uploading media for social posts, checking post status, creating X/Twitter threads, or automating social media workflows.
Postiz Social Media Scheduler
Direct API integration for social media posting. No n8n workflows needed.
Quick Reference
Platform
Integration ID
Character Limit
Handle
X/Twitter
cml5lbs3h0001o6l6gagj9gcq
280
@CoolmannSa
LinkedIn
cml5k1d710001s69hwekkhx1p
3,000
kuhlmannsascha
Bluesky
cml5mre6w0009o6l6svc718ej
300
coolmanns.bsky.social
Platform Content Guidelines
X/Twitter (280 chars)
Short, punchy content
1-2 hashtags max
Links count as 23 chars (t.co shortening)
Threads for longer content (multiple tweets)
LinkedIn (3,000 chars)
Professional tone
Can be longer-form
Hashtags at end (3-5 recommended)
First 140 chars show in preview — make them count!
Bluesky (300 chars)
Similar to X but slightly more room
No official hashtag support (use sparingly)
Growing tech/developer audience
Authentication
# Login and save cookie (required before any API call)
curl -s -c /tmp/postiz-cookies.txt \
'https://postiz.home.mykuhlmann.com/api/auth/login' \
-H 'Content-Type: application/json' \
-d '{"email":"sascha@mykuhlmann.com","password":"Postiz2026!","provider":"LOCAL"}'
Cookie expires periodically. Re-run login if you get 401 errors.
"value":[{"content":"Post with image","image":[{"id":"MEDIA_ID","path":"/uploads/..."}]}]
Twitter/X Threads
For longer content on X, create a thread:
"value":[{"content":"Tweet 1/3: Introduction to the topic...","image":[]},{"content":"Tweet 2/3: The main point explained...","image":[]},{"content":"Tweet 3/3: Conclusion and call to action.","image":[]}]
Always query existing posts before creating new ones
Use unique identifiers in content (dates, specific references)
Check both QUEUE and PUBLISHED states
Scheduling
Space posts at least 2-4 hours apart per platform
Best times: 9 AM, 12 PM, 5 PM (audience timezone)
Avoid posting same content to all platforms simultaneously
Content Adaptation
Don't just truncate! Rewrite for each platform:
X: Hook + key insight + CTA
LinkedIn: Context + value + engagement question
Bluesky: Casual tech-friendly tone
Helper Script
Use scripts/post.py for easier posting with automatic character validation:
# Single platform
~/.local/bin/uv run ~/clawd/skills/postiz/scripts/post.py \
--platform x \
--content "Your tweet here" \
--schedule "2026-02-05T15:00:00Z"# Multi-platform with different content
~/.local/bin/uv run ~/clawd/skills/postiz/scripts/post.py \
--x "Short X version" \
--linkedin "Longer LinkedIn version with more detail" \
--bluesky "Bluesky version" \
--schedule "2026-02-05T15:00:00Z"
