Developers

ViralGenHub has a Public API and an MCP server, so you can schedule posts from your own scripts and tools, or from an AI assistant.

Who can use it

The Public API and the MCP server are included in every plan, Free too. The Free plan allows 100 requests a day for each workspace (API and MCP together) and answers with a 429 error after that, until the next day (UTC). The Creator and Business plans have no daily cap. See Pricing.

Your API key is in the app under Settings > API & MCP. The key gives access to your whole workspace, so keep it secret. You can rotate it on the same page, which stops the old key working.

The basics

Base URL: https://app.viralgenhub.com/api/public/v1
Authentication: send your API key in the Authorization header, on its own (no Bearer prefix).
Rate limit: creating posts (POST /posts) is limited to 30 requests per hour for each workspace. One request can post to several channels.

For example, with your key in the VIRALGENHUB_API_KEY environment variable:

curl -H "Authorization: $VIRALGENHUB_API_KEY" \
  https://app.viralgenhub.com/api/public/v1/integrations

Main endpoints

Paths are relative to the base URL.

Method	Path	What it does
`GET`	`/integrations`	List your connected channels (id, name, platform). Optional `?group=` filter.
`GET`	`/find-slot/:id`	The next free time slot for a channel.
`POST`	`/upload`	Upload an image or video (multipart form, field `file`).
`POST`	`/upload-from-url`	Upload media from a public URL.
`GET`	`/media`	List your media library.
`POST`	`/posts`	Create a post: schedule it, post it now, or save it as a draft.
`GET`	`/posts`	List posts between `startDate` and `endDate`.
`DELETE`	`/posts/:id`	Delete a post, together with the other posts in its group.
`PUT`	`/posts/:id/status`	Switch a post between draft and scheduled.
`GET`	`/integration-settings/:id`	A channel's rules, maximum length and the settings it needs.
`GET`	`/analytics/:integration`	The figures a platform shares for a channel.
`GET`	`/notifications`	Your notifications.
`GET`	`/is-connected`	Check that your API key works.

The API is the Postiz public API (ViralGenHub is built on Postiz), so Postiz's public API reference describes the request bodies. Use the base URL above instead of Postiz's. In the app, Open Wizard on the API & MCP page lets you build a post on screen and copy the request it makes.

MCP server

Connect an AI assistant that supports MCP (Model Context Protocol, over HTTP) so it can schedule posts for you.

Sign in with OAuth: https://app.viralgenhub.com/api/mcp-oauth-dynamic. Your assistant opens a ViralGenHub sign-in page; there is no key to paste.
With your API key: https://app.viralgenhub.com/api/mcp with the header Authorization: Bearer YOUR_API_KEY. For assistants that only accept a URL, use https://app.viralgenhub.com/api/mcp/YOUR_API_KEY and keep that URL secret.

The API & MCP page in the app gives ready-made settings for Claude Code, Cursor, VS Code / Copilot, Windsurf, Codex, Gemini CLI and others. For example, in Claude Code:

claude mcp add viralgenhub --transport http "https://app.viralgenhub.com/api/mcp-oauth-dynamic"

Webhooks

Webhooks call a URL of yours when your posts publish, so your own tools can react. Set them up in the app. The Free plan includes 1 webhook, Creator 2 and Business 10.

Questions

Email support@viralgenhub.com. The app's source code is public if you want to read how an endpoint works. Security issues: see Security.