API Documentation

Integrate KontentKannon with your automation workflows, AI agents, and custom applications.

Authentication

All API requests require an API key. Create one in Settings > API Keys.

# REST API (N8N, Zapier, etc.)

Authorization: Bearer kk_live_xxxxxxxxxxxxxxxx


# MCP Server (Claude, GPT agents)

X-API-Key: kk_live_xxxxxxxxxxxxxxxx

Endpoints

POST/api/webhooks/n8n

Create, list, or query analytics for content items

Auth: API Key (Bearer kk_live_xxx)

createCreate and optionally publish a post
{ "action": "create", "body": "Hello!", "platforms": ["TWITTER", "LINKEDIN"], "publish": true }
listList content items with optional status filter
{ "action": "list", "status": "PUBLISHED", "limit": 20 }
analyticsGet aggregate analytics across all posts
{ "action": "analytics" }
POST/api/mcp

MCP (Model Context Protocol) server for AI agents

Auth: API Key (X-API-Key header)

tools/listList available tools
{ "method": "tools/list", "id": 1 }
tools/callCall a tool (create_post, list_platforms, list_content, get_analytics, create_from_template)
{ "method": "tools/call", "params": { "name": "create_post", "arguments": { "text": "Hello!", "platforms": ["TWITTER"], "publish": false } }, "id": 2 }
POST/api/webhooks/stripe

Stripe webhook handler for billing events

Auth: Stripe signature (automatic)

Webhook Events

Configure outbound webhooks in Settings to receive real-time notifications when events occur. All webhook payloads include an HMAC-SHA256 signature in the X-KK-Signature header.

EventDescription
post.publishedContent was successfully published to one or more platforms
post.failedContent publishing failed on all target platforms
post.scheduledContent was scheduled for future publishing
content.createdA new content item was created
content.approvedContent was approved by a reviewer
content.rejectedContent was rejected and sent back to draft
account.connectedA new social/newsletter/blog platform was connected
account.disconnectedA platform connection was removed
engagement.newNew comments, mentions, or DMs were received

Rate Limits

PlanPer Platform/hrGlobal/hr
Solo30100
Creator100500
Agency3002,000
Enterprise1,00010,000