API Reference

The Praisma Hub API allows developers to extend functionality, integrate with third-party systems, and automate content workflows. Below are the core guidelines and endpoints.

Authentication

All requests require a valid API token. You can generate tokens in the Settings → API Keys section.

GET /v1/posts
Authorization: Bearer YOUR_API_TOKEN

Pagination

Endpoints returning collections use cursor-based pagination. Include ?limit=20&cursor=abc123 in your query.

Rate Limits

Requests are limited to 100 per minute per tenant. Exceeding this will return 429 Too Many Requests.

Webhooks

Use webhooks to receive real-time updates about events like new messages, scheduled post status, or workflow approvals. Configure these under Settings → Webhooks.

Example Endpoints

• GET /v1/posts — List all posts for a tenant.
• POST /v1/posts — Create a new post.
• GET /v1/inbox/messages — Retrieve messages from the inbox.
• POST /v1/inbox/messages/reply — Send a reply in the unified inbox.
• GET /v1/analytics/summary — Fetch analytics summary for selected channels.