Developer API — PostMind AI

Base URL

https://api.postmindai.pro/api/v1

Authentication

Obtain a JWT by calling POST /auth/login with email and password, or use OAuth via POST /auth/oauth. Include the access token on every request:

Authorization: Bearer <access_token>
x-workspace-id: <workspace_uuid>

Access tokens expire in 15 minutes. Refresh with POST /auth/refresh using your refresh token.

Core endpoints

Method	Path	Description
GET	/posts	List workspace posts
POST	/posts	Create a post
POST	/ai/generate/monthly-plan	Generate AI campaign
GET	/social/accounts	Connected platforms
GET	/library/assets	Media library assets
GET	/analytics/overview	Performance metrics

Response format

All responses use a standard envelope:

{
  "success": true,
  "data": { ... },
  "meta": { "page": 1, "total": 42 }
}

Rate limits

Default: 100 requests per 60 seconds per IP. Auth endpoints have stricter limits (login: 10/min, register: 5/min).

Enterprise & webhooks

Webhook delivery for post status changes and billing events is available on Business and Enterprise plans. Contact api@postmind.ai for early access and OpenAPI spec export.

New to PostMind? Start with the documentation or create a free account.