Skip to content

Developer docs

Build on GroZro

GroZro is an AI-native social growth operator. It drafts platform-native post batches from your growth profile, learns from your analytics, and keeps every post behind your approval. Everything the app does is available programmatically — three surfaces, one tenant API key.

Three surfaces, one key

SurfaceBest forStart here
REST APIScripts, integrations, anything with curlAPI reference
MCPClaude Code, Cursor, and other AI clientsMCP guide
CLIDriving the queue from a terminalCLI reference

Or skip all of this: hand the setup to your AI agent →

Quickstart

  1. Create an API key at app.grozro.com → Settings → Developer access. The key is shown once — treat it like a password. Keys carry the scopes api:read, api:write, mcp:use.
  2. Make your first call — base URL https://api.grozro.com, Bearer auth:
    curl -H "Authorization: Bearer ak_…" \
      https://api.grozro.com/api/v1/growth/items?status=drafted
  3. Run the loop — draft, review, post:
  • GET /api/v1/growth/connection Verify the key. Returns the connected X account; 401 means the key is wrong.
  • GET /api/v1/growth/overview See the workspace. Profile, channels, drafted queue, and learnings in one call.
  • POST /api/v1/growth/batches Draft a batch. Body {"count": 6, "focus": "launch week"}. Generation is async.
  • POST /api/v1/growth/articles Draft an article. Body {"topic": "…", "length": "medium"}. Long-form X article.
  • GET /api/v1/growth/items?status=drafted Review the queue. Poll until drafts land (usually under a minute).
  • POST /api/v1/growth/items/{id}/approve Approve or reject. Optional {"edited_body": "…"}; /reject takes {"reason": "…"}.
  • POST /api/v1/growth/items/{id}/post-now Post or schedule. Or /schedule with {"post_at": ISO-8601} — the worker posts when due.

Docs for machines