Postoria Public API is now available

Postoria Public API is now available for Pro and Agency users.

This update lets developers, agencies, and businesses connect external systems to Postoria and automate social media publishing workflows without manually creating every post in the app.

With the Public API, you can upload media, create posts, schedule content, add posts to queues, and check publishing status programmatically.

What you can do with the Public API

Postoria Public API v1 focuses on the core publishing workflow.

You can use it to:

• List available workspaces
• List connected social accounts in a workspace
• List queues in a workspace
• Upload media with a temporary upload URL
• Import media from a public HTTPS URL
• Check media processing status
• Create posts
• Publish now, schedule, or add posts to a queue
• Check post status
• Delete posts

This makes it easier to connect Postoria with your own tools, scripts, content pipelines, internal dashboards, CMS workflows, and automation systems.

Built for practical publishing automation

The first version of the API is intentionally focused.

Instead of trying to expose every Postoria feature at once, Public API v1 covers the workflow most integrations need first:

1. Get a workspace
2. Get social accounts or queues
3. Upload or import media
4. Create a post
5. Check post status

This keeps the API easier to understand and safer to integrate with, while still supporting real publishing use cases.

Media upload and processing

Media can be added in two ways.

The first option is to create a temporary upload URL. Your system uploads the file bytes to that URL using HTTP PUT, then tells Postoria to complete the upload. Postoria processes the media in the background.

The second option is to import media from a public HTTPS URL. This is useful when media already exists in a CMS, DAM, website, or another external system.

In both cases, media processing is asynchronous. After creating or importing media, use the media status endpoint until the media item becomes ready. Ready media can then be used when creating a post.

Create posts from external systems

The Public API can create posts for one or more connected social accounts.

Posts can be created in three publishing modes:

• publish_now
• schedule
• queue

Scheduled posts use UTC date and time values. Queue posts use an existing Postoria queue from the selected workspace.

The API supports structured post fields such as captions, media, links, first comments, YouTube options, TikTok options, and repost settings, following the same general publishing capabilities available in Postoria’s bulk upload workflow.

Check publishing results

After creating a post, you can check its status through the API.

The post response includes the post ID, status, and account-level results. When a post is published successfully, Postoria returns the published link where available. If publishing fails for an account, the response includes the error for that account.

This makes it possible to build simple polling workflows without webhooks in the first version.

Authentication and limits

Each Postoria profile can create one active API key from the Public API section in Settings.

The API uses bearer token authentication:

Authorization: Bearer pst_live_your_api_key

For safety and reliability, Public API v1 is rate limited to 300 requests per 5 minutes per account.

API keys are shown only once when created. If a key is lost or exposed, revoke it and create a new one.

Documentation

Full Public API documentation is available in the Postoria Help Center:

How to use the Postoria Public API

The interactive API reference is available here:

Open the Public API reference

The OpenAPI document is available here:

Open the OpenAPI document

What’s next

Public API v1 gives Postoria users a straightforward way to integrate external systems with the core publishing workflow.

We will continue improving the API based on real usage and customer feedback. Future additions may include more advanced integration options.