Skip to main content
Version: 1.0.0

Mixpost API

The Mixpost REST API lets third-party services create, schedule and manage social media content on your own Mixpost instance.

Base URL

Every endpoint is served from your own installation, under the Mixpost core path:

https://example.com/{corePath}/api

{corePath} is the value of the MIXPOST_CORE_PATH environment variable, which defaults to mixpost. Replace example.com with your instance host.

From Pro v7 and Enterprise v8 this prefix is empty by default and the API moves to https://example.com/api.

Editions

Endpoints tagged Workspaces, Subscriptions, Users and Receipts are served from the admin panel of Mixpost Enterprise only. All other endpoints are available in Mixpost Pro and Enterprise.

Authentication

Mixpost access token, sent as Authorization: Bearer <token>.

The token is read from the Authorization header only — there is no query-string, cookie, or custom-header fallback.

Creating a token. Tokens are created from the Access Tokens page in the dashboard. You give the token a name and an expiry: 7, 30, 60 or 90 days, a custom date, or never expires. The token value is shown exactly once at creation and is stored hashed, so it can never be retrieved again — copy it immediately. A token is rejected once its expiry date has passed.

Tokens have no scopes. A token carries no abilities of its own: it inherits the full authority of the user who created it. Which endpoints it can reach is determined entirely by that user's workspace role (see the role matrix below), not by anything set on the token.

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Contact

Mixpost:

URL: https://mixpost.app

On this page