Postiz
Connect Postiz to the AI agent: connected social channels, the post feed, free slots and analytics
Connect Postiz to the AI agent: connected social channels, the post feed, free slots and analytics. The agent fans one announcement out and schedules it.
DocumentationАнонс релиза стоит в расписании на пять каналов, старт в 10:30.
- X и Mastodon — короткая версия на 240 знаков со ссылкой
- LinkedIn и Telegram — развёрнутый текст с тремя пунктами изменений
- Слот на 10:30 был свободен во всех каналах, кроме TikTok — там перенёс на 14:00
Integration 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.
What the agent does in the first 10 minutes
- Will fan a single announcement out to every connected channel at once — X, LinkedIn, Telegram, Mastodon — with its own wording per platform.
- Will queue posts into the free slots of your schedule and show what is already planned for the coming week.
- Will send a weekly digest of reach and engagement per channel and name the posts that outperformed the rest.
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.
