# Groniz Documentation

## Docs

- [Introduction](https://docs.groniz.com/introduction.md): Welcome to Groniz documentation
- [Quickstart](https://docs.groniz.com/quickstart.md): Connect a channel and schedule your first post in minutes
- [Introduction](https://docs.groniz.com/cli/introduction.md): Automate social media posting from the command line with the Groniz CLI
- [Authentication](https://docs.groniz.com/cli/authentication.md): Set up OAuth2 or API key authentication for the Groniz CLI
- [Managing Posts](https://docs.groniz.com/cli/managing-posts.md): Create, list, and delete social media posts from the command line
- [Integrations](https://docs.groniz.com/cli/integrations.md): Discover connected accounts, settings schemas, and dynamic tools
- [Analytics](https://docs.groniz.com/cli/analytics.md): View platform and post-level analytics from the command line
- [Media Upload](https://docs.groniz.com/cli/media-upload.md): Upload images, videos, and other media files for use in posts
- [Platform Examples](https://docs.groniz.com/cli/platform-examples.md): Ready-to-use examples for posting to specific platforms
- [Introduction](https://docs.groniz.com/mcp/introduction.md): Connect AI agents to Groniz using the Model Context Protocol (MCP)
- [Client Setup](https://docs.groniz.com/mcp/setup.md): Configure your AI client to connect to the Groniz MCP server
- [Tools Reference](https://docs.groniz.com/mcp/tools.md): Complete reference for all Groniz MCP tools
- [Examples](https://docs.groniz.com/mcp/examples.md): Common workflows when using Groniz through MCP
- [Troubleshooting](https://docs.groniz.com/troubleshooting/overview.md): Common Groniz problems and how to resolve them
- [OAuth & Channel Connect Errors](https://docs.groniz.com/troubleshooting/oauth-connect.md): Invalid state, invalid_grant, and fetch failed during the connect flow
- [Uploads & Media](https://docs.groniz.com/troubleshooting/uploads.md): Payload limits, upload-from-url, video, and cancel-in-flight behaviour
- [Activation & Login](https://docs.groniz.com/troubleshooting/activation-and-login.md): Expired activation links, "jwt malformed", and login API responses
- [Billing](https://docs.groniz.com/troubleshooting/billing.md): Stripe.js blocked, billing page in incognito, discount errors
- [Channel Limits](https://docs.groniz.com/troubleshooting/channel-limits.md): "You have reached the maximum number of channels"
- [Known Issues](https://docs.groniz.com/troubleshooting/known-issues.md): Live tracker of bugs we are aware of, with workarounds where possible
- [Support](https://docs.groniz.com/support.md): Get help with Groniz
- [API Overview](https://docs.groniz.com/public-api/introduction.md): Getting started with the Groniz Public API
- [List Integrations](https://docs.groniz.com/public-api/integrations/list.md): Returns all connected social media channels for your organization.
- [List Groups (Customers)](https://docs.groniz.com/public-api/integrations/groups.md): Returns all customers (groups) for your organization. Use a group ID to filter the integrations list.
- [Connect Channel (OAuth)](https://docs.groniz.com/public-api/integrations/connect.md): Generate an OAuth authorization URL for a given integration. Use this to connect a new social media channel. Only OAuth-based integrations are supported (integrations that require an external URL, such as Mastodon, are not available via this endpoint).
- [Get Settings & Tools](https://docs.groniz.com/public-api/integrations/settings.md): Returns the posting rules, maximum content length, settings schema, and available provider tools for a connected channel. Use this to discover which tools can be executed with the trigger endpoint.
- [Trigger a Tool](https://docs.groniz.com/public-api/integrations/trigger.md): Executes a provider-specific tool on a connected channel, for example searching Instagram audio for Reels, listing Discord channels, or fetching Reddit flairs. Discover available tools with the integration settings endpoint.
- [Delete Channel](https://docs.groniz.com/public-api/integrations/delete.md): Delete a connected channel by its integration ID. Any scheduled posts associated with this channel will also be deleted.
- [Check Connection](https://docs.groniz.com/public-api/integrations/is-connected.md): Verify if your API key is valid and connected.
- [Find Available Slot](https://docs.groniz.com/public-api/integrations/find-slot.md): Get the next available time slot for posting to a specific channel.
- [List Posts](https://docs.groniz.com/public-api/posts/list.md): Get posts within a date range.
- [Create Post](https://docs.groniz.com/public-api/posts/create.md): Create a draft, queue immediate publication, or schedule a new post. Each social media platform has its own settings schema.
- [Delete Post](https://docs.groniz.com/public-api/posts/delete.md): Delete a post by its ID. The API will look up the post and delete all posts in the same group.
- [Delete Post by Group](https://docs.groniz.com/public-api/posts/delete-by-group.md): Delete all posts in a group by the group identifier.
- [Get Missing Content](https://docs.groniz.com/public-api/posts/missing-content.md): When a post has been published but the platform did not return a usable post ID (the `releaseId` is set to `"missing"`), this endpoint fetches recent content from the provider so you can match and connect the correct one to the post.
- [Update Release ID](https://docs.groniz.com/public-api/posts/update-release-id.md): Updates the `releaseId` of a post that currently has its release ID set to `"missing"`. This connects the post to its actual published content on the platform, enabling analytics and statistics tracking.
- [Change Post Status](https://docs.groniz.com/public-api/posts/change-status.md): Moves a post between `draft` and `schedule` state.
- [Platform Analytics](https://docs.groniz.com/public-api/analytics/platform.md): Get analytics data for a specific integration/channel. Returns metrics like followers, impressions, engagement, etc. depending on the platform.
- [Post Analytics](https://docs.groniz.com/public-api/analytics/post.md): Get analytics data for a specific published post. Returns metrics like likes, comments, shares, impressions, etc. depending on the platform.
- [Read Profile](https://docs.groniz.com/public-api/reads/profile.md): Profile and follower counts for ANY public account — no connected channel required. Metered per upstream call.
- [Read Posts](https://docs.groniz.com/public-api/reads/posts.md): Recent posts by any public account, newest first. Each post carries its engagement metrics.
- [Read Post](https://docs.groniz.com/public-api/reads/post.md): One post, by its platform id.
- [Search Posts](https://docs.groniz.com/public-api/reads/search.md): Search recent public posts. The platform's own search operators work (e.g. `from:user`, `-filter:replies`).
- [Read Metrics](https://docs.groniz.com/public-api/reads/metrics.md): Totals and averages across an account's posts in a window, plus the posts themselves. For YOUR OWN connected channel prefer `GET /analytics/{integration}` — it answers the same question over the channel's OAuth token, for free.
- [List Notifications](https://docs.groniz.com/public-api/notifications/list.md): Get paginated notifications for your organization, sorted by most recent first. Returns 100 notifications per page.
- [Upload File](https://docs.groniz.com/public-api/uploads/upload-file.md): Upload a media file using multipart form data.
- [Upload from URL](https://docs.groniz.com/public-api/uploads/upload-from-url.md): Upload a file from an existing URL.
- [Generate Video](https://docs.groniz.com/public-api/video/generate.md): Create AI-generated videos for your posts.
- [Video Function](https://docs.groniz.com/public-api/video/function.md): Execute video-related functions like loading available voices.
- [X (Twitter) Settings](https://docs.groniz.com/public-api/providers/x.md): API settings for posting to X/Twitter
- [LinkedIn Settings](https://docs.groniz.com/public-api/providers/linkedin.md): API settings for posting to LinkedIn
- [LinkedIn Page Settings](https://docs.groniz.com/public-api/providers/linkedin-page.md): API settings for posting to LinkedIn company pages
- [Facebook Settings](https://docs.groniz.com/public-api/providers/facebook.md): Provider settings for Facebook posts
- [Instagram Settings](https://docs.groniz.com/public-api/providers/instagram.md): API settings for posting to Instagram
- [Instagram Standalone Settings](https://docs.groniz.com/public-api/providers/instagram-standalone.md): API settings for posting to standalone Instagram accounts
- [Threads Settings](https://docs.groniz.com/public-api/providers/threads.md): API settings for posting to Threads
- [Bluesky Settings](https://docs.groniz.com/public-api/providers/bluesky.md): API settings for posting to Bluesky
- [Mastodon Settings](https://docs.groniz.com/public-api/providers/mastodon.md): API settings for posting to Mastodon
- [Warpcast (Farcaster) Settings](https://docs.groniz.com/public-api/providers/warpcast.md): Provider settings for Warpcast/Farcaster posts
- [Nostr Settings](https://docs.groniz.com/public-api/providers/nostr.md): API settings for posting to Nostr
- [VK Settings](https://docs.groniz.com/public-api/providers/vk.md): API settings for posting to VK (VKontakte)
- [YouTube Settings](https://docs.groniz.com/public-api/providers/youtube.md): API settings for posting to YouTube
- [TikTok Settings](https://docs.groniz.com/public-api/providers/tiktok.md): API settings for posting to TikTok
- [Reddit Settings](https://docs.groniz.com/public-api/providers/reddit.md): API settings for posting to Reddit
- [Lemmy Settings](https://docs.groniz.com/public-api/providers/lemmy.md): Provider settings for Lemmy posts
- [Pinterest Settings](https://docs.groniz.com/public-api/providers/pinterest.md): API settings for posting to Pinterest
- [Discord Settings](https://docs.groniz.com/public-api/providers/discord.md): API settings for posting to Discord
- [Slack Settings](https://docs.groniz.com/public-api/providers/slack.md): API settings for posting to Slack
- [Telegram Settings](https://docs.groniz.com/public-api/providers/telegram.md): API settings for posting to Telegram
- [Dribbble Settings](https://docs.groniz.com/public-api/providers/dribbble.md): API settings for posting to Dribbble
- [Medium Settings](https://docs.groniz.com/public-api/providers/medium.md): Provider settings for Medium articles
- [Dev.to Settings](https://docs.groniz.com/public-api/providers/devto.md): Provider settings for Dev.to articles
- [Hashnode Settings](https://docs.groniz.com/public-api/providers/hashnode.md): Provider settings for Hashnode articles
- [WordPress Settings](https://docs.groniz.com/public-api/providers/wordpress.md): Provider settings for WordPress posts
- [Listmonk Settings](https://docs.groniz.com/public-api/providers/listmonk.md): Provider settings for Listmonk newsletter campaigns
- [Google My Business Settings](https://docs.groniz.com/public-api/providers/gmb.md): Provider settings for Google My Business posts
- [Whop Settings](https://docs.groniz.com/public-api/providers/whop.md): API settings for posting to Whop forums
- [Skool Settings](https://docs.groniz.com/public-api/providers/skool.md): API settings for posting to Skool communities
- [Kick Settings](https://docs.groniz.com/public-api/providers/kick.md): API settings for posting to Kick
- [Twitch Settings](https://docs.groniz.com/public-api/providers/twitch.md): API settings for posting to Twitch chat
- [Moltbook Settings](https://docs.groniz.com/public-api/providers/moltbook.md): API settings for posting to Moltbook
- [OAuth2 Authentication](https://docs.groniz.com/public-api/oauth.md): Let users authorize your app to access Groniz on their behalf

## OpenAPI Specs

- [openapi](https://docs.groniz.com/public-api/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.