Developer docs

The JSON API, incoming webhooks, and the MCP endpoint share one bearer key.

Authentication

Send the header Authorization: Bearer sp_…

Routes

  • GET /api/v1/channels
  • GET /api/v1/posts
  • POST /api/v1/posts
  • PATCH /api/v1/posts/:id
  • POST /api/v1/posts/:id/schedule
  • DELETE /api/v1/posts/:id
  • GET /api/v1/ideas
  • POST /api/v1/ideas
  • GET /api/v1/insights/summary
  • GET /api/v1/queue

MCP

POST /mcp speaks JSON-RPC. tools/list returns these tools:

  • list_channels
  • list_queue
  • create_post
  • save_idea
  • insights_summary

A plan limit comes back as HTTP 200 with result.isError set, plus a message you can show.

Webhooks

POST /hooks/:id/:token accepts a JSON body. A bad token is rejected. This route does not count against the API limiter.