# Postiz Documentation - [Introduction](https://docs.postiz.com/general/introduction.md): Schedule and publish to 34 social platforms from one calendar - [Schedule your first post](https://docs.postiz.com/general/quickstart.md): From an empty account to a scheduled post, in five steps - [How Postiz works](https://docs.postiz.com/general/concepts.md): The words Postiz uses, defined once - [Finding your way around](https://docs.postiz.com/general/where-things-live.md): What every section of the app is for, and which ones you may not see - [Connect a channel](https://docs.postiz.com/general/channels/connect.md): The four ways a platform connects, and what to do when one fails - [Manage a channel](https://docs.postiz.com/general/channels/manage.md): Reconnect, rename, disable, delete, and everything in the channel menu - [Posting time slots](https://docs.postiz.com/general/channels/time-slots.md): Set the times a channel normally posts, and what depends on them - [Client groups and invite links](https://docs.postiz.com/general/channels/customers.md): Group channels per client, filter the calendar, and let clients connect their own accounts - [The post composer](https://docs.postiz.com/general/composer/overview.md): How the composer is laid out and what each part does - [Global vs per-channel content](https://docs.postiz.com/general/composer/global-vs-per-channel.md): Write once for everything, or tailor one channel without touching the others - [Writing the post](https://docs.postiz.com/general/composer/writing.md): The editor, formatting, mentions, emoji and character counts - [Threads and comments](https://docs.postiz.com/general/composer/threads-and-comments.md): Multi-part posts, what each platform does with them, and delays between parts - [Images and video](https://docs.postiz.com/general/composer/media.md): Adding media, alt text, video thumbnails, size limits and the design editor - [AI generation](https://docs.postiz.com/general/composer/ai-and-imports.md): Generate images, video and whole posts, and how credits work - [Scheduling and publishing](https://docs.postiz.com/general/composer/scheduling.md): Draft, schedule, post now, and repeat a post on a cycle - [Links and validation errors](https://docs.postiz.com/general/composer/links-and-validation.md): Short links, link stripping, and why the composer will not let you save - [The calendar](https://docs.postiz.com/general/calendar/overview.md): Day, week, month and list views, and how to filter them - [Moving and rescheduling posts](https://docs.postiz.com/general/calendar/moving-posts.md): Drag and drop on the calendar, and what happens to a published post - [Post actions and statistics](https://docs.postiz.com/general/posts/actions-and-stats.md): Duplicate, preview, delete, and read per-post performance - [Sharing a post for approval](https://docs.postiz.com/general/approvals.md): Send a client a preview link and collect their comments - [Analytics](https://docs.postiz.com/general/analytics.md): Which platforms report metrics, what they report, and over what period - [Media library](https://docs.postiz.com/general/media-library.md): Everything you have uploaded, in one searchable place - [Plugs](https://docs.postiz.com/general/automations/plugs.md): Auto-repost and auto-comment when a post performs well - [RSS auto-posting](https://docs.postiz.com/general/automations/auto-post-rss.md): Turn a feed into scheduled posts, with or without AI rewriting - [Webhooks](https://docs.postiz.com/general/automations/webhooks.md): Notify another system when Postiz publishes - [Third-party integrations](https://docs.postiz.com/general/automations/third-party.md): Pull generated media from external services into your posts - [The AI agent](https://docs.postiz.com/general/agents.md): Chat your way to a scheduled post - [Video clipping](https://docs.postiz.com/general/clipping.md): Turn a long YouTube video into captioned vertical clips and draft posts - [Settings](https://docs.postiz.com/general/settings/overview.md): The settings tabs, and why one might be missing - [Team members](https://docs.postiz.com/general/settings/team.md): Invite people into your organisation and set what they can do - [Sets and signatures](https://docs.postiz.com/general/settings/reusables.md): Save a channel selection, and a sign-off you reuse on every post - [Developer settings](https://docs.postiz.com/general/settings/developers.md): API keys, OAuth apps, and connecting the CLI or an AI client - [Posting rules by platform](https://docs.postiz.com/general/platforms/overview.md): Every supported platform, what it can carry, and what each one is called in the API - [Troubleshooting](https://docs.postiz.com/general/troubleshooting/overview.md): Common Postiz problems and how to resolve them - [OAuth & Channel Connect Errors](https://docs.postiz.com/general/troubleshooting/oauth-connect.md): Invalid state, invalid_grant, and fetch failed during the connect flow - [Uploads & Media](https://docs.postiz.com/general/troubleshooting/uploads.md): Payload limits, upload-from-url, video, and cancel-in-flight behaviour - [Activation and login](https://docs.postiz.com/general/troubleshooting/activation-and-login.md): Expired activation links, "jwt malformed", and login API responses - [Known Issues](https://docs.postiz.com/general/troubleshooting/known-issues.md): Live tracker of bugs we are aware of, with workarounds where possible - [Support](https://docs.postiz.com/general/support.md): How to get help, and what level of support to expect - [Postiz Cloud](https://docs.postiz.com/cloud/overview.md): What the hosted version gives you, and how it differs from self-hosting - [Plans and limits](https://docs.postiz.com/cloud/plans.md): Every Postiz Cloud tier, what it costs and what it includes - [The free trial](https://docs.postiz.com/cloud/trial.md): How the 7 day trial works, and how to end it early - [Managing your subscription](https://docs.postiz.com/cloud/subscription.md): Upgrade, downgrade, switch billing period, cancel, and find invoices - [Limits and what happens when you hit them](https://docs.postiz.com/cloud/limits.md): Every cap, the error it produces, and how to clear it - [Downgrades and cancellation](https://docs.postiz.com/cloud/downgrades.md): What actually changes in your account when a plan shrinks - [Codes, offers and affiliates](https://docs.postiz.com/cloud/codes-and-offers.md): Lifetime deals, promo codes, retention offers and the affiliate programme - [Refunds and support](https://docs.postiz.com/cloud/refunds-and-support.md): Getting money back, fixing billing page problems, and reaching a person - [Installation options](https://docs.postiz.com/self-host/installation/overview.md): Choose how to run your own Postiz instance - [System Requirements](https://docs.postiz.com/self-host/installation/system-requirements.md): Hardware, services, ports, and network requirements for self-hosting Postiz - [How it works](https://docs.postiz.com/self-host/architecture.md): Learn the architecture of the project - [Docker Compose](https://docs.postiz.com/self-host/installation/docker-compose.md): Install Postiz using Docker Compose - [Docker](https://docs.postiz.com/self-host/installation/docker.md): Install Postiz using Docker standalone - [Helm](https://docs.postiz.com/self-host/installation/kubernetes-helm.md): Install Postiz using Kubernetes and Helm - [Dev Container](https://docs.postiz.com/self-host/installation/devcontainer.md): Install Postiz using Dev Container - [Development Environment](https://docs.postiz.com/self-host/installation/development.md): Set up Postiz for local development - [Migration to Temporal](https://docs.postiz.com/self-host/installation/migration.md): A guide to migrating to the new Temporal infrastructure - [Configuration Reference](https://docs.postiz.com/self-host/configuration/reference.md): Environment variables reference for Postiz - [Docker Compose Configuration](https://docs.postiz.com/self-host/configuration/docker.md): How to configure your docker-compose file for Postiz - [Email Notifications](https://docs.postiz.com/self-host/configuration/emails.md): How to send notifications to users - [Uploads & Storage](https://docs.postiz.com/self-host/configuration/uploads.md): Local filesystem vs Cloudflare R2 for media uploads - [R2 Configuration](https://docs.postiz.com/self-host/configuration/r2.md): How to use Cloudflare R2 for file storage - [OIDC Configuration](https://docs.postiz.com/self-host/configuration/oauth.md): How to configure OIDC for Postiz - [Image and video editing (Polotno)](https://docs.postiz.com/self-host/configuration/polotno.md): Enable the in-app design editor on a self-hosted instance - [Video clipping](https://docs.postiz.com/self-host/configuration/clipping.md): Enable YouTube video clipping on a self-hosted instance - [Browser extension](https://docs.postiz.com/self-host/configuration/chrome-extension.md): Configure the Postiz browser extension on a self-hosted instance - [Caddy](https://docs.postiz.com/self-host/reverse-proxies/caddy.md): Configure Caddy as a reverse proxy for Postiz - [Nginx](https://docs.postiz.com/self-host/reverse-proxies/nginx.md): Configure Nginx as a reverse proxy for Postiz - [Traefik + Docker Compose](https://docs.postiz.com/self-host/reverse-proxies/traefik.md): Configure Traefik as a reverse proxy for Postiz - [WebSockets, HMR, and Dev Tunnels](https://docs.postiz.com/self-host/reverse-proxies/websockets-and-dev.md): Running Postiz behind ngrok or a reverse proxy with WebSocket support - [Provider API keys](https://docs.postiz.com/self-host/providers/overview.md): Which platforms need a developer app, and how to configure them - [X (Twitter)](https://docs.postiz.com/self-host/providers/x-twitter.md): How to add X to your system - [LinkedIn](https://docs.postiz.com/self-host/providers/linkedin.md): How to add LinkedIn to your system - [LinkedIn Page](https://docs.postiz.com/self-host/providers/linkedin-page.md): How to add a LinkedIn Page to your system - [Facebook](https://docs.postiz.com/self-host/providers/facebook.md): How to add Facebook to your system - [Instagram](https://docs.postiz.com/self-host/providers/instagram.md): How to add Instagram to your system - [Threads](https://docs.postiz.com/self-host/providers/threads.md): How to add Threads to your system - [Bluesky](https://docs.postiz.com/self-host/providers/bluesky.md): How to add Bluesky to Postiz - [Mastodon](https://docs.postiz.com/self-host/providers/mastodon.md): How to add Mastodon to your system - [Google My Business](https://docs.postiz.com/self-host/providers/google-my-business.md): How to add Google My Business to your system - [MeWe](https://docs.postiz.com/self-host/providers/mewe.md): How to add MeWe to your system - [Farcaster](https://docs.postiz.com/self-host/providers/farcaster.md): How to add Farcaster (Warpcast) to your system - [YouTube](https://docs.postiz.com/self-host/providers/youtube.md): How to Add YouTube to Your System - [TikTok](https://docs.postiz.com/self-host/providers/tiktok.md): How to add TikTok to your system - [Reddit](https://docs.postiz.com/self-host/providers/reddit.md): How to add Reddit to your system - [Pinterest](https://docs.postiz.com/self-host/providers/pinterest.md): How to add Pinterest to your system - [Discord](https://docs.postiz.com/self-host/providers/discord.md): How to add Discord to your system - [Slack](https://docs.postiz.com/self-host/providers/slack.md): How to add Slack to your system - [Telegram](https://docs.postiz.com/self-host/providers/telegram.md): How to add Telegram to your system - [Dribbble](https://docs.postiz.com/self-host/providers/dribbble.md): How to add Dribbble to your system - [Skool](https://docs.postiz.com/self-host/providers/skool.md): How to add Skool to Postiz - [Whop](https://docs.postiz.com/self-host/providers/whop.md): How to add Whop to Postiz - [Tumblr](https://docs.postiz.com/self-host/providers/tumblr.md): How to add Tumblr to your Postiz instance - [Self-Host Gotchas](https://docs.postiz.com/self-host/troubleshooting.md): Common problems specific to running Postiz yourself - [API Overview](https://docs.postiz.com/public-api/introduction.md): Getting started with the Postiz Public API - [List Integrations](https://docs.postiz.com/public-api/integrations/list.md): Returns all connected social media channels for your organization. - [List Groups (Customers)](https://docs.postiz.com/public-api/integrations/groups.md): Returns all customers (groups) for your organization. Use a group ID to filter the integrations list. - [Connect Channel (OAuth)](https://docs.postiz.com/public-api/integrations/connect.md): Generate an OAuth authorization URL for a given integration. Use this to connect a new social media channel. Only OAuth-based integrations are supported (integrations that require an external URL, such as Mastodon, are not available via this endpoint). - [Get Settings & Tools](https://docs.postiz.com/public-api/integrations/settings.md): Returns the posting rules, maximum content length, settings schema, and available provider tools for a connected channel. Use this to discover which tools can be executed with the trigger endpoint. - [Trigger a Tool](https://docs.postiz.com/public-api/integrations/trigger.md): Executes a provider-specific tool on a connected channel, for example searching Instagram audio for Reels, listing Discord channels, or fetching Reddit flairs. Discover available tools with the integration settings endpoint. - [Delete Channel](https://docs.postiz.com/public-api/integrations/delete.md): Delete a connected channel by its integration ID. Any scheduled posts associated with this channel will also be deleted. - [Check Connection](https://docs.postiz.com/public-api/integrations/is-connected.md): Verify if your API key is valid and connected. - [Get Connected Account](https://docs.postiz.com/public-api/integrations/me.md): Returns the workspace these credentials act on. With an OAuth app token it also returns the Postiz user who approved the app, so your integration can show who is connected. API keys belong to the whole workspace, so `user` is `null`. - [Find Available Slot](https://docs.postiz.com/public-api/integrations/find-slot.md): Get the next available time slot for posting to a specific channel. - [List Posts](https://docs.postiz.com/public-api/posts/list.md): Get posts within a date range. - [Create Post](https://docs.postiz.com/public-api/posts/create.md): Create or schedule a new post. Each social media platform has its own settings schema. - [Delete Post](https://docs.postiz.com/public-api/posts/delete.md): Delete a post by its ID. The API will look up the post and delete all posts in the same group. - [Delete Post by Group](https://docs.postiz.com/public-api/posts/delete-by-group.md): Delete all posts in a group by the group identifier. - [Get Missing Content](https://docs.postiz.com/public-api/posts/missing-content.md): When a post has been published but the platform did not return a usable post ID (the `releaseId` is set to `"missing"`), this endpoint fetches recent content from the provider so you can match and connect the correct one to the post. - [Update Release ID](https://docs.postiz.com/public-api/posts/update-release-id.md): Updates the `releaseId` of a post that currently has its release ID set to `"missing"`. This connects the post to its actual published content on the platform, enabling analytics and statistics tracking. - [Change Post Status](https://docs.postiz.com/public-api/posts/change-status.md): Moves a post between `draft` and `schedule` state. - [Update Post Settings](https://docs.postiz.com/public-api/posts/settings.md): Merges the given keys into the post's existing provider settings. Only the keys you pass are changed; content and publish date are untouched, so a running publishing workflow is not restarted. The merged settings are re-validated. Works only on not-yet-published posts (scheduled or draft). - [Platform Analytics](https://docs.postiz.com/public-api/analytics/platform.md): Get analytics data for a specific integration/channel. Returns metrics like followers, impressions, engagement, etc. depending on the platform. - [Post Analytics](https://docs.postiz.com/public-api/analytics/post.md): Get analytics data for a specific published post. Returns metrics like likes, comments, shares, impressions, etc. depending on the platform. - [List Notifications](https://docs.postiz.com/public-api/notifications/list.md): Get paginated notifications for your organization, sorted by most recent first. Returns 100 notifications per page. - [Upload File](https://docs.postiz.com/public-api/uploads/upload-file.md): Upload a media file using multipart form data. - [Upload from URL](https://docs.postiz.com/public-api/uploads/upload-from-url.md): Upload a file from an existing URL. - [List Media](https://docs.postiz.com/public-api/uploads/list-media.md): List the media files already uploaded to your organization's media library, newest first, 18 per page. - [Generate Video](https://docs.postiz.com/public-api/video/generate.md): Create AI-generated videos for your posts. - [Video Function](https://docs.postiz.com/public-api/video/function.md): Execute video-related functions like loading available voices. - [Start a Clipping](https://docs.postiz.com/public-api/clipping/create.md): Turn a long YouTube video into short vertical clips with burned-in captions. The best parts are picked automatically, every clip is saved to the media library, and when integrations are passed a draft post is created for every clip on every integration. Nothing is scheduled or published. - [Get a Clipping](https://docs.postiz.com/public-api/clipping/get.md): Get the status of a clipping and its clips. Poll it (every 30 seconds is plenty) until the status is `completed` or `failed`. - [List Clippings](https://docs.postiz.com/public-api/clipping/list.md): Get the clippings of your organization, most recent first, 20 per page. The clips themselves are returned by [Get a clipping](/public-api/clipping/get). - [X (Twitter) Settings](https://docs.postiz.com/public-api/providers/x.md): API settings for posting to X/Twitter - [LinkedIn Settings](https://docs.postiz.com/public-api/providers/linkedin.md): API settings for posting to LinkedIn - [LinkedIn Page Settings](https://docs.postiz.com/public-api/providers/linkedin-page.md): API settings for posting to LinkedIn company pages - [Facebook Settings](https://docs.postiz.com/public-api/providers/facebook.md): Provider settings for Facebook posts - [Instagram Settings](https://docs.postiz.com/public-api/providers/instagram.md): API settings for posting to Instagram - [Instagram Standalone Settings](https://docs.postiz.com/public-api/providers/instagram-standalone.md): API settings for posting to standalone Instagram accounts - [Threads Settings](https://docs.postiz.com/public-api/providers/threads.md): API settings for posting to Threads - [Bluesky Settings](https://docs.postiz.com/public-api/providers/bluesky.md): API settings for posting to Bluesky - [Mastodon Settings](https://docs.postiz.com/public-api/providers/mastodon.md): API settings for posting to Mastodon - [Warpcast (Farcaster) Settings](https://docs.postiz.com/public-api/providers/warpcast.md): Provider settings for Warpcast/Farcaster posts - [Nostr Settings](https://docs.postiz.com/public-api/providers/nostr.md): API settings for posting to Nostr - [VK Settings](https://docs.postiz.com/public-api/providers/vk.md): API settings for posting to VK (VKontakte) - [YouTube Settings](https://docs.postiz.com/public-api/providers/youtube.md): API settings for posting to YouTube - [TikTok Settings](https://docs.postiz.com/public-api/providers/tiktok.md): API settings for posting to TikTok - [Reddit Settings](https://docs.postiz.com/public-api/providers/reddit.md): API settings for posting to Reddit - [Lemmy Settings](https://docs.postiz.com/public-api/providers/lemmy.md): Provider settings for Lemmy posts - [Pinterest Settings](https://docs.postiz.com/public-api/providers/pinterest.md): API settings for posting to Pinterest - [Discord Settings](https://docs.postiz.com/public-api/providers/discord.md): API settings for posting to Discord - [Slack Settings](https://docs.postiz.com/public-api/providers/slack.md): API settings for posting to Slack - [Telegram Settings](https://docs.postiz.com/public-api/providers/telegram.md): API settings for posting to Telegram - [Dribbble Settings](https://docs.postiz.com/public-api/providers/dribbble.md): API settings for posting to Dribbble - [Medium Settings](https://docs.postiz.com/public-api/providers/medium.md): Provider settings for Medium articles - [Dev.to Settings](https://docs.postiz.com/public-api/providers/devto.md): Provider settings for Dev.to articles - [Hashnode Settings](https://docs.postiz.com/public-api/providers/hashnode.md): Provider settings for Hashnode articles - [WordPress Settings](https://docs.postiz.com/public-api/providers/wordpress.md): Provider settings for WordPress posts - [Listmonk Settings](https://docs.postiz.com/public-api/providers/listmonk.md): Provider settings for Listmonk newsletter campaigns - [Google My Business Settings](https://docs.postiz.com/public-api/providers/gmb.md): Provider settings for Google My Business posts - [Whop Settings](https://docs.postiz.com/public-api/providers/whop.md): API settings for posting to Whop forums - [Skool Settings](https://docs.postiz.com/public-api/providers/skool.md): API settings for posting to Skool communities - [Kick Settings](https://docs.postiz.com/public-api/providers/kick.md): API settings for posting to Kick - [Twitch Settings](https://docs.postiz.com/public-api/providers/twitch.md): API settings for posting to Twitch chat - [Moltbook Settings](https://docs.postiz.com/public-api/providers/moltbook.md): API settings for posting to Moltbook - [MeWe Settings](https://docs.postiz.com/public-api/providers/mewe.md): Provider settings for MeWe posts - [Tumblr Settings](https://docs.postiz.com/public-api/providers/tumblr.md): Provider settings for Tumblr posts - [Introduction](https://docs.postiz.com/cli/introduction.md): Automate social media posting from the command line with the Postiz CLI - [Authentication](https://docs.postiz.com/cli/authentication.md): Set up OAuth2 or API key authentication for the Postiz CLI - [Managing Posts](https://docs.postiz.com/cli/managing-posts.md): Create, list, and delete social media posts from the command line - [Integrations](https://docs.postiz.com/cli/integrations.md): Discover connected accounts, settings schemas, and dynamic tools - [Analytics](https://docs.postiz.com/cli/analytics.md): View platform and post-level analytics from the command line - [Media Upload](https://docs.postiz.com/cli/media-upload.md): Upload images, videos, and other media files for use in posts - [Clipping](https://docs.postiz.com/cli/clipping.md): Turn a long YouTube video into captioned vertical clips from the command line - [Platform Examples](https://docs.postiz.com/cli/platform-examples.md): Ready-to-use examples for posting to specific platforms - [Self-hosting the CLI auth server](https://docs.postiz.com/self-host/cli-auth-server.md): Run your own OAuth2 device-flow server for the Postiz CLI login - [Introduction](https://docs.postiz.com/mcp/introduction.md): Connect AI agents to Postiz using the Model Context Protocol (MCP) - [Client Setup](https://docs.postiz.com/mcp/setup.md): Configure your AI client to connect to the Postiz MCP server - [Tools Reference](https://docs.postiz.com/mcp/tools.md): Complete reference for all Postiz MCP tools - [Examples](https://docs.postiz.com/mcp/examples.md): Common workflows when using Postiz through MCP - [OAuth2 Authentication](https://docs.postiz.com/oauth.md): Let users authorize your app to access Postiz on their behalf - [Developer Guide](https://docs.postiz.com/contributing/developer-guide.md): How to get started developing with Postiz - [How to add a new provider](https://docs.postiz.com/contributing/create-provider.md): How to add a new provider to Postiz ## OpenAPI Specs - [openapi](/public-api/openapi.json) ## Optional - [GitHub](https://github.com/gitroomhq/postiz-app) - [Discord](https://discord.postiz.com) - [YouTube](https://youtube.com/@postizofficial) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.