gitroomhq/postiz-docs

Overview

This skill connects Postiz scheduling features to your workflow, letting you create, upload media for, and schedule posts across 28+ social and chat channels from a single API. It simplifies multi-channel publishing by exposing account integrations, upload endpoints, slot finding, and post management. Use it to programmatically queue content, manage media, and inspect scheduled posts.

How this skill works

The skill calls Postiz public API endpoints to list connected channels, find the next available scheduling slot for a channel, upload media (from file or URL), create scheduled posts, list posts by date range, and delete posts. Authentication uses your Postiz API key via an Authorization header. Uploaded media must be served from uploads.postiz.com and referenced by the returned upload id/path when scheduling posts.

When to use it

• Automate publishing across many social networks from one integration.
• Schedule recurring or timed campaigns without manual posting.
• Pre-upload and attach media to posts programmatically.
• Query your scheduled calendar to build dashboards or reporting.
• Remove or update scheduled posts from automation pipelines.

Best practices

• Store the POSTIZ_API_KEY securely in environment variables and never hard-code it.
• Upload media first and use the upload response id/path (uploads.postiz.com) when scheduling posts.
• Check channel-specific settings in Postiz docs before scheduling; providers require different fields.
• Use find-slot endpoint to respect optimal posting times per channel before scheduling.
• Paginate and filter post list requests by date and customer to limit response size.

Example use cases

• Bulk schedule a product launch across X, LinkedIn, Instagram, Threads, and TikTok with one API call.
• Automate image uploads from your CDN and embed returned upload paths into scheduled posts.
• Generate a content calendar view by querying posts between startDate and endDate for a given customer.
• Build an admin tool that finds the next available slot for each channel and queues curated content accordingly.
• Programmatically delete or reschedule posts if a campaign strategy changes.