Home / Features / API and MCP
API and MCP

Schedule posts from your own tools and AI agents

A public API, an MCP server for AI apps, a command line tool and signed webhooks, all included in every plan.

What you can do

Public API

Create, list, move and delete posts, upload media and list channels. The paths and bodies follow the Postiz public API, so many existing scripts work after you change the address and key.

MCP server

Connect Claude, ChatGPT, Cursor or any MCP app. Sign in with OAuth or use your API key. 20 tools, from listing channels to scheduling posts.

Command line tool

Schedule posts from your terminal or CI with the postozo command.

Signed webhooks

Get events like post published, post failed and approval requested, signed with HMAC and retried up to 6 times.

n8n, Make and Zapier

Use the API from your automation tool of choice.

Your key, your control

Rotate your API key any time and see which AI apps are connected.

How it works

Use the social media API in 4 steps

Get your key

In the app, open Settings, Developers. Copy your API key, or let an AI app sign in with OAuth instead.

Pick how to connect

Call the public API over HTTP, run the postozo command line tool, or add the MCP server to Claude, ChatGPT, Cursor or another MCP app.

Check before you post

Ask for a channel's rules or check a post against every channel before saving it, the same checks the editor runs.

Listen for events

Add a webhook for the events you need. Each call is signed with HMAC and retried up to 6 times, with a delivery log.

Example: posts from an AI chat

A consultant adds the MCP server to Claude. She writes: "Plan 3 LinkedIn posts about our new course for next week and put them in my free slots." Claude lists her channels, finds free slots, checks each post against LinkedIn's rules and schedules them. She sees them on the calendar and edits 1 before it goes out. A webhook tells her CRM when each post is published.

Tips to get more from it

  • Read a channel's rules through the API, or use the check_post tool over MCP, before you create posts from a script, so you catch the same problems the editor would show.
  • Store the API key as a secret in your automation tool. Rotate it if it ever ends up in a log.
  • Use the find free slot tool so posts from scripts and AI apps respect the posting times your team set.

Who it is for

  • Marketing teams connect the calendar to their CRM and reports. See Marketing teams.
  • Agencies build their own client dashboards on top of the API. See Agencies.
  • Creators schedule posts by talking to their AI app. See Creators.

Plans and limits

The public API, MCP server and command line tool are in every plan. The number of webhooks grows with the plan. See Pricing for every limit.

LimitStandardTeamProUltimate
Public API, MCP and command line toolYesYesYesYes
Webhooks2103010,000

Step by step guides for AI apps

Set up the MCP server or the API in the tool you already use:

See all AI agent guides.

Works with these channels

API and MCP works on every connected channel. These are the ones people use it with most:

See all channels, or compare Postozo with other tools on the compare page.

FAQ

Questions

Where do I find my API key?

In the app under Settings, Developers.

What is MCP?

Model Context Protocol, a standard way for AI apps to use tools. With it, an AI app can read your channels and schedule posts for you.

Is the API included in every plan?

Yes.

Which webhook events are there?

Post published, post failed, post could not be confirmed, approval requested, post approved, changes requested, channel disconnected and plan changed.

Will my Postiz scripts work?

The public API follows the same paths and bodies as the Postiz public API, so many scripts work after you change the address and the key. Test yours first.

Is the social media API free?

It is included in every Postozo plan at no extra cost. There is no separate API fee.

What is a social media scheduling API?

An API that lets your own code create, move and delete scheduled posts. The Postozo API does this for all 30 channel types with 1 key.

Start planning your posts today

Create your account and publish your first post in 5 minutes.

Create your free account