Developer platform

Everything Growvo does, your code can do

One API key drives the same pipeline as the app: 13-network publishing, scheduling, AI images and video, media, and analytics — from curl, n8n, Make, Zapier, or an AI agent over MCP.

REST API

Publish, schedule, generate, and read analytics over plain HTTPS with a gv_live_ key.

MCP server

Expose the whole API as tools for Claude, Cursor, or any MCP-capable agent.

n8n · Make · Zapier

Official n8n node, a native Make app, and Zapier support for no-code automation.

Webhook target

Publish to your own endpoint like any other network — JSON body, HMAC-signed.

Quickstart

  1. 1. Create an API key in the dashboard under Settings → API keys. The plaintext gv_live_… key is shown once at creation — store it somewhere safe.
  2. 2. Verify it against the live API (the key acts as you, inside your workspace):
bashCheck your key
curl -H "Authorization: Bearer REDACTED" \
  https://api.growvo.ai/v1/me

3. Publish your first post — the response is always a per-network result list:

bashPublish to two networks
curl -X POST \
  -H "Authorization: Bearer REDACTED" \
  -H "Content-Type: application/json" \
  -d '{"networks":["mastodon","bluesky"],"text":"Shipped v2 today"}' \
  https://api.growvo.ai/v1/posts

API surface at a glance

All paths are relative to https://api.growvo.ai. Authenticate with Authorization: Bearer or x-api-key.

Identity & accounts

  • GET /v1/me

    The key’s identity and workspace — a cheap credentials check.

  • GET /v1/accounts

    Connected social accounts (credentials never leave the server).

Publishing & scheduling

  • POST /v1/posts

    Publish now to up to 13 networks — variants, threads, media, webhook target.

  • POST /v1/schedule

    Create a scheduled content-calendar event.

  • GET /v1/calendar/next-slot

    Compute the next free scheduling slot (read-only).

Content & outputs

  • GET /v1/outputs

    Saved AI outputs, newest first, with content previews.

  • GET /v1/sources

    Describes the URL-ingestion capability and its limits.

  • POST /v1/sources/ingest

    Fetch a public URL → title + readable plaintext (SSRF-guarded).

Analytics

  • GET /v1/analytics/posts

    Stored post metrics with a weighted engagement score.

  • GET /v1/analytics/posts/top

    Top performers by engagement inside a date window.

Media

  • GET /v1/media

    The workspace media library, newest first.

  • POST /v1/media

    Register an image/video from a public URL into the library.

Generation

  • POST /v1/images

    Generate an image straight into the media library.

  • POST /v1/videos

    Build a faceless-video storyboard; optionally enqueue the MP4 render.

Full request/response reference, field tables, and error codes: PUBLIC_API.md on GitHub.

MCP server — give your agent hands

growvo-mcp exposes the public API as Model Context Protocol tools — me, list_accounts, publish_post, schedule_post, list_outputs — for Claude Desktop, Claude Code, Cursor, or your own agent. It is stateless: every tool call is an authenticated request to the live API with the key’s exact permissions.

jsonclaude_desktop_config.json
{
  "mcpServers": {
    "growvo": {
      "command": "npx",
      "args": ["-y", "@growvo/mcp-server"],
      "env": { "GROWVO_API_KEY": "REDACTED" }
    }
  }
}
bashClaude Code
claude mcp add growvo \
  --env GROWVO_API_KEY=REDACTED \
  -- npx -y @growvo/mcp-server

Setup details and the full tool reference: MCP.md on GitHub.

No-code & low-code automation

Official n8n node

Drop Growvo into any n8n workflow: publish posts, schedule events, and read outputs as first-class nodes — no HTTP wrangling, credentials handled once.

Make & Zapier

A native Make app plus Zapier support connect Growvo to thousands of other tools — trigger a publish from a form, a sheet, a CRM stage, anything.

Webhook publish target

Connect a webhook once and it behaves like a 13th network: every publish POSTs JSON to your endpoint, HMAC-SHA256 signed when you set a secret.

jsonWhat your webhook endpoint receives
{
  "text": "Shipped v2 today",
  "title": "Launch post",
  "link": "https://growvo.ai/blog/v2",
  "mediaUrls": ["https://cdn.example.com/hero.png"],
  "additionalPosts": ["Thread post 2", "Thread post 3"],
  "publishedAt": "2026-07-18T10:00:00.000Z"
}

Auth & rate limits

  • Keys act as the user who created them — workspace membership and role permissions are re-checked live on every request.
  • Revoking a key in the app takes effect immediately.
  • Send the key as Authorization: Bearer or x-api-key.
  • 60 requests/minute per key; over budget → 429 with Retry-After.
  • 30 failed auth attempts/minute per IP before /v1 requests are throttled.
  • Publishing and generation draw from your plan’s monthly quotas — BYOK workspaces are uncapped on their own provider keys.

Ship your first integration today

Create a free workspace, mint a key in Settings → API keys, and you’re one curl away from publishing.

Get your API keyRead the API docs