# Nushir > Plan, schedule and publish social content across every channel from one calendar. ## Guide ### Get started - [Nushir](https://docs.nushir.com/general/introduction.md): Plan, schedule and publish social content across every channel from one calendar. - [Schedule your first post](https://docs.nushir.com/general/quickstart.md): From an empty account to a scheduled post, in five steps. - [How Nushir works](https://docs.nushir.com/general/concepts.md): The words Nushir uses, defined once. - [Finding your way around](https://docs.nushir.com/general/where-things-live.md): What each part of the app is for, and why you may not see all of it. ### Channels - [Connect a channel](https://docs.nushir.com/general/channels/connect.md): The ways a platform connects, and what to do when one fails. - [Manage a channel](https://docs.nushir.com/general/channels/manage.md): Reconnect, rename, disable, delete. - [Posting times](https://docs.nushir.com/general/channels/time-slots.md): Set the times a channel normally posts, and what depends on them. - [Client groups](https://docs.nushir.com/general/channels/customers.md): Group channels per client and filter the calendar to one at a time. ### Creating posts - [The composer](https://docs.nushir.com/general/composer/overview.md): How the composer is laid out and what each part does. - [Global vs per-channel content](https://docs.nushir.com/general/composer/global-vs-per-channel.md): Write once for everything, or tailor one channel without touching the others. - [Writing the post](https://docs.nushir.com/general/composer/writing.md): The editor, formatting, mentions and character counts. - [Threads and comments](https://docs.nushir.com/general/composer/threads-and-comments.md): Multi-part posts, and what each platform does with them. - [Images and video](https://docs.nushir.com/general/composer/media.md): Adding media, and the limits that actually bite. - [AI generation](https://docs.nushir.com/general/composer/ai-and-imports.md): Generate text and media in the composer, and how credits work. - [Scheduling and publishing](https://docs.nushir.com/general/composer/scheduling.md): Draft, schedule, post now. - [Why the composer will not save](https://docs.nushir.com/general/composer/links-and-validation.md): The validation rules, and how to read what they are telling you. ### Calendar and posts - [The calendar](https://docs.nushir.com/general/calendar/overview.md): Day, week and month views, and moving posts around. - [Moving and rescheduling posts](https://docs.nushir.com/general/calendar/moving-posts.md): Drag and drop, and what happens when the post has already published. - [Post actions and statistics](https://docs.nushir.com/general/posts/actions-and-stats.md): Duplicate, preview, delete, and per-post performance. - [Sharing a post for approval](https://docs.nushir.com/general/approvals.md): Send a preview link and collect comments before anything publishes. ### Insights - [Analytics](https://docs.nushir.com/general/analytics.md): Which platforms report metrics, and what they report. - [Media library](https://docs.nushir.com/general/media-library.md): Everything you have uploaded, in one place. ### Automation - [Plugs](https://docs.nushir.com/general/automations/plugs.md): Automatic follow-up actions on posts that perform. - [RSS auto-posting](https://docs.nushir.com/general/automations/auto-post-rss.md): Turn a feed into scheduled posts. - [Webhooks](https://docs.nushir.com/general/automations/webhooks.md): Notify another system when Nushir publishes. - [Third-party integrations](https://docs.nushir.com/general/automations/third-party.md): Pull generated media from external services into your posts. - [The AI agent](https://docs.nushir.com/general/agents.md): Chat your way to a scheduled post. - [Connect your assistant to Nushir](https://docs.nushir.com/mcp/introduction.md): MCP setup, media uploads, confirmations and troubleshooting. ### Settings - [Settings](https://docs.nushir.com/general/settings/overview.md): The settings tabs, and why one might be missing. - [Team members](https://docs.nushir.com/general/settings/team.md): Invite people and set what they can do. - [Sets and signatures](https://docs.nushir.com/general/settings/reusables.md): Save a channel selection, and a sign-off you reuse on every post. - [API keys](https://docs.nushir.com/general/settings/developers.md): Create a key, and keep it safe. ### Platforms - [Platform reference](https://docs.nushir.com/general/platforms/overview.md): Every supported platform, what it can carry, and what it is called in the API. - [X](https://docs.nushir.com/general/platforms/x.md): Connecting X, and the rules it enforces. - [LinkedIn](https://docs.nushir.com/general/platforms/linkedin.md): Connecting LinkedIn, and the rules it enforces. - [Facebook Page](https://docs.nushir.com/general/platforms/facebook.md): Connecting Facebook Page, and the rules it enforces. - [Instagram](https://docs.nushir.com/general/platforms/instagram.md): Connecting Instagram, and the rules it enforces. - [Threads](https://docs.nushir.com/general/platforms/threads.md): Connecting Threads, and the rules it enforces. - [TikTok](https://docs.nushir.com/general/platforms/tiktok.md): Connecting TikTok, and the rules it enforces. - [YouTube](https://docs.nushir.com/general/platforms/youtube.md): Connecting YouTube, and the rules it enforces. - [Pinterest](https://docs.nushir.com/general/platforms/pinterest.md): Connecting Pinterest, and the rules it enforces. - [Reddit](https://docs.nushir.com/general/platforms/reddit.md): Connecting Reddit, and the rules it enforces. - [Discord](https://docs.nushir.com/general/platforms/discord.md): Connecting Discord, and the rules it enforces. - [Telegram](https://docs.nushir.com/general/platforms/telegram.md): Connecting Telegram, and the rules it enforces. - [Slack](https://docs.nushir.com/general/platforms/slack.md): Connecting Slack, and the rules it enforces. - [Mastodon](https://docs.nushir.com/general/platforms/mastodon.md): Connecting Mastodon, and the rules it enforces. - [Bluesky](https://docs.nushir.com/general/platforms/bluesky.md): Connecting Bluesky, and the rules it enforces. ### Troubleshooting - [Troubleshooting](https://docs.nushir.com/general/troubleshooting/overview.md): Start here when something misbehaves. - [Channel connection problems](https://docs.nushir.com/general/troubleshooting/oauth-connect.md): Why a connection fails, and what actually fixes it. - [A post did not publish](https://docs.nushir.com/general/troubleshooting/publishing.md): Reading the failure, and what to do about it. - [Upload and media problems](https://docs.nushir.com/general/troubleshooting/uploads.md): Uploads that fail, and video that is rejected. - [Activation and login](https://docs.nushir.com/general/troubleshooting/activation-and-login.md): Sign-in problems, and the errors behind them. - [Known issues](https://docs.nushir.com/general/troubleshooting/known-issues.md): Current limitations worth knowing before you hit them. ### Help - [Support](https://docs.nushir.com/general/support.md): How to reach us, and what to include. ## Public API ### Getting started - [API introduction](https://docs.nushir.com/public-api/introduction.md): Drive Nushir from your own code. - [Authentication](https://docs.nushir.com/public-api/authentication.md): One header, two kinds of credential. - [OAuth apps](https://docs.nushir.com/public-api/oauth.md): Let other people connect their Nushir account to your product. - [Errors](https://docs.nushir.com/public-api/errors.md): What each status means, and what it usually is. - [Channel settings](https://docs.nushir.com/public-api/channel-settings.md): The per-platform object that POST /posts requires. ### Integrations - [List channels](https://docs.nushir.com/public-api/integrations/list.md): Every channel connected to your organisation, including disabled ones. - [Disconnect a channel](https://docs.nushir.com/public-api/integrations/delete.md): Disconnects the channel and deletes the stored credentials. - [settings](https://docs.nushir.com/public-api/integrations/settings.md): The saved per-channel options — the defaults applied when a post does not specify its own `settings`. - [Check for any working channel](https://docs.nushir.com/public-api/integrations/is-connected.md): A cheap health check: does this organisation have at least one channel that could publish right now? - [List client groups](https://docs.nushir.com/public-api/integrations/groups.md): Client groups bundle channels per customer, so an agency can filter the calendar to one client at a time. - [Begin connecting a channel](https://docs.nushir.com/public-api/integrations/connect.md): Returns the platform's authorisation URL. Send the user there; they approve access on the platform and are returned to Nushir, which completes the exchange and stores the credentials. - [Find the next free slot](https://docs.nushir.com/public-api/integrations/find-slot.md): Returns the next posting time that is free for this channel, according to its configured time slots and what is already scheduled. ### Posts - [List posts](https://docs.nushir.com/public-api/posts/list.md): Posts in a date window. Both bounds are required — there is no unbounded listing. - [Create a post](https://docs.nushir.com/public-api/posts/create.md): Creates a post on one or more channels. - [Delete a post](https://docs.nushir.com/public-api/posts/delete.md): Deletes one post. If it has already published, this removes Nushir's record — it does **not** delete anything from the platform. - [Delete a post group](https://docs.nushir.com/public-api/posts/delete-by-group.md): Deletes every post sharing a `group` — the cross-channel counterpart to deleting a single post. - [What is stopping this post](https://docs.nushir.com/public-api/posts/missing-content.md): Reports what a post still needs before it can publish — a required settings field, a missing image, a caption over the platform's limit. - [Update per-channel settings](https://docs.nushir.com/public-api/posts/settings.md): Replaces the platform-specific settings on an existing post. - [Change post status](https://docs.nushir.com/public-api/posts/change-status.md): Moves a post between states — for example promoting a draft into the queue, or pulling a queued post back to a draft. - [Record the published URL](https://docs.nushir.com/public-api/posts/update-release-id.md): Attaches the platform's own post id and URL to a Nushir post. ### Uploads - [Upload a file](https://docs.nushir.com/public-api/uploads/upload-file.md): Uploads media and returns an id to reference from a post's `image` array. - [Upload from a URL](https://docs.nushir.com/public-api/uploads/upload-from-url.md): Fetches a file server-side and stores it, so a large video never has to travel through your own process. ### Analytics - [Channel analytics](https://docs.nushir.com/public-api/analytics/platform.md): Account-level figures for one channel — followers, views and the like. - [Post analytics](https://docs.nushir.com/public-api/analytics/post.md): Per-post performance, for platforms that report it. Only meaningful once the post has published. ### Notifications - [List notifications](https://docs.nushir.com/public-api/notifications/list.md): Account notifications, newest first. ### Video - [Generate a video](https://docs.nushir.com/public-api/video/generate.md): Starts a generation job on the configured video provider. Available only when the deployment has one configured, and it consumes plan credits. - [Call a video provider function](https://docs.nushir.com/public-api/video/function.md): Invokes a named function on the video provider — used by the composer to drive provider-specific steps. ### Providers - [Bluesky](https://docs.nushir.com/public-api/providers/bluesky.md): Posting to `bluesky` channels - no settings object required. - [Dev.to](https://docs.nushir.com/public-api/providers/devto.md): The `settings` object for `devto` channels on POST /posts. - [Discord](https://docs.nushir.com/public-api/providers/discord.md): The `settings` object for `discord` channels on POST /posts. - [Dribbble](https://docs.nushir.com/public-api/providers/dribbble.md): The `settings` object for `dribbble` channels on POST /posts. - [Facebook Page](https://docs.nushir.com/public-api/providers/facebook.md): The `settings` object for `facebook` channels on POST /posts. - [Google My Business](https://docs.nushir.com/public-api/providers/gmb.md): The `settings` object for `gmb` channels on POST /posts. - [Hashnode](https://docs.nushir.com/public-api/providers/hashnode.md): The `settings` object for `hashnode` channels on POST /posts. - [Instagram](https://docs.nushir.com/public-api/providers/instagram.md): The `settings` object for `instagram` channels on POST /posts. - [Instagram (Standalone)](https://docs.nushir.com/public-api/providers/instagram-standalone.md): The `settings` object for `instagram-standalone` channels on POST /posts. - [Kick](https://docs.nushir.com/public-api/providers/kick.md): The `settings` object for `kick` channels on POST /posts. - [Lemmy](https://docs.nushir.com/public-api/providers/lemmy.md): The `settings` object for `lemmy` channels on POST /posts. - [LinkedIn](https://docs.nushir.com/public-api/providers/linkedin.md): The `settings` object for `linkedin` channels on POST /posts. - [LinkedIn Page](https://docs.nushir.com/public-api/providers/linkedin-page.md): The `settings` object for `linkedin-page` channels on POST /posts. - [ListMonk](https://docs.nushir.com/public-api/providers/listmonk.md): The `settings` object for `listmonk` channels on POST /posts. - [Mastodon](https://docs.nushir.com/public-api/providers/mastodon.md): Posting to `mastodon` channels - no settings object required. - [Medium](https://docs.nushir.com/public-api/providers/medium.md): The `settings` object for `medium` channels on POST /posts. - [MeWe](https://docs.nushir.com/public-api/providers/mewe.md): The `settings` object for `mewe` channels on POST /posts. - [Moltbook](https://docs.nushir.com/public-api/providers/moltbook.md): The `settings` object for `moltbook` channels on POST /posts. - [Nostr](https://docs.nushir.com/public-api/providers/nostr.md): Posting to `nostr` channels - no settings object required. - [Pinterest](https://docs.nushir.com/public-api/providers/pinterest.md): The `settings` object for `pinterest` channels on POST /posts. - [Reddit](https://docs.nushir.com/public-api/providers/reddit.md): The `settings` object for `reddit` channels on POST /posts. - [Skool](https://docs.nushir.com/public-api/providers/skool.md): The `settings` object for `skool` channels on POST /posts. - [Slack](https://docs.nushir.com/public-api/providers/slack.md): The `settings` object for `slack` channels on POST /posts. - [Telegram](https://docs.nushir.com/public-api/providers/telegram.md): Posting to `telegram` channels - no settings object required. - [Threads](https://docs.nushir.com/public-api/providers/threads.md): Posting to `threads` channels - no settings object required. - [TikTok](https://docs.nushir.com/public-api/providers/tiktok.md): The `settings` object for `tiktok` channels on POST /posts. - [Tumblr](https://docs.nushir.com/public-api/providers/tumblr.md): The `settings` object for `tumblr` channels on POST /posts. - [Twitch](https://docs.nushir.com/public-api/providers/twitch.md): The `settings` object for `twitch` channels on POST /posts. - [VK](https://docs.nushir.com/public-api/providers/vk.md): Posting to `vk` channels - no settings object required. - [Whop](https://docs.nushir.com/public-api/providers/whop.md): The `settings` object for `whop` channels on POST /posts. - [WordPress](https://docs.nushir.com/public-api/providers/wordpress.md): The `settings` object for `wordpress` channels on POST /posts. - [Warpcast (Farcaster)](https://docs.nushir.com/public-api/providers/wrapcast.md): The `settings` object for `wrapcast` channels on POST /posts. - [X](https://docs.nushir.com/public-api/providers/x.md): The `settings` object for `x` channels on POST /posts. - [YouTube](https://docs.nushir.com/public-api/providers/youtube.md): The `settings` object for `youtube` channels on POST /posts. ## Cloud ### The hosted service - [The hosted service](https://docs.nushir.com/cloud/overview.md): What being on the cloud means, and where its boundaries are. - [Plans](https://docs.nushir.com/cloud/plans.md): What each tier includes. - [The trial](https://docs.nushir.com/cloud/trial.md): Seven days, card at signup, first charge at the end. - [Billing](https://docs.nushir.com/cloud/subscription.md): Payment, invoices and cancellation. ### Limits and changes - [Limits](https://docs.nushir.com/cloud/limits.md): How plan limits are counted, and what happens at the edge. - [Upgrades and downgrades](https://docs.nushir.com/cloud/downgrades.md): When each takes effect, and what happens to the excess. ### Offers and refunds - [Codes and offers](https://docs.nushir.com/cloud/codes-and-offers.md): Redeeming a promotional code, and how discounts apply. - [Refunds and billing support](https://docs.nushir.com/cloud/refunds-and-support.md): The refund position, and how to raise a billing issue. ## OpenAPI Specs - [openapi](/public-api/openapi.yaml) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Arabic (123 pages)](https://docs.nushir.com/_llms/ar.txt): Documentation for Arabic. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.