# Postiz

Self-hosted или cloud планировщик соцсетей — X, LinkedIn, Bluesky, Mastodon, Discord, Telegram, TikTok и др.; ключ из Settings → Developers → Public API

## Scenarios

### One announcement across every channel
The agent fans a single announcement out to your connected Postiz channels — X, LinkedIn, Telegram, Mastodon — with wording tuned to each platform.

### A publishing plan for the week
The agent finds free slots in the channel schedules, queues the posts and shows what is already lined up for the days ahead.

### Channel reach at a glance
The agent pulls analytics for connected channels over 7, 30 or 90 days and names the posts that drew more reactions than the rest.

### Confirmation that a post went live
The agent reads the Postiz notification feed and shows which publications went through and which ones the platform rejected, with the error.

## How to connect

### Sign in as the workspace owner
Cloud users go to postiz.com; self-hosted users open their own Postiz address. The key belongs to the whole workspace, so you need the account that owns it.

### Connect at least one social channel
On the main Postiz screen add the channels you will publish to — X, LinkedIn, Telegram, Bluesky, Mastodon, TikTok and others. Without them the key still works, but there is nowhere to publish.

### Copy the key from Settings → Developers → Public API
Open «Settings» → «Developers» → «Public API» and copy the whole key. It is sent as-is, with no prefix; Postiz OAuth2 tokens starting with pos_ are a separate flow and are not needed here.

### Note your instance address
Cloud has a single address — https://api.postiz.com. For self-hosted take the root address of your instance, the same one the dashboard opens at; no API path needs to be appended.

## FAQ

### How do I connect Postiz?
With a Public API key: in Postiz open Settings, then Developers, then Public API, and copy the key in full — it is sent without a prefix. The second field is the instance address: https://api.postiz.com for the cloud, or the root address of your workspace for self-hosted.

### What does the agent see in Postiz?
Connected social accounts, the post feed for a period, free schedule slots, analytics for channels and individual posts, and notifications about publication results.

### Does the agent write to Postiz?
Yes: it creates drafts and scheduled posts, moves a post between draft and schedule, uploads media, and can delete posts and disconnect channels.

### What about rate limits?
The Postiz Public API allows 30 requests per hour across all endpoints, so fan-out publishing to several platforms is packed into a single request with an array of posts.

[Open Postiz](https://postiz.com)