# PostOnce

> Help center and developer documentation for PostOnce: connect social accounts, cross-post automatically, schedule posts, fix failed posts, and use the Public API and MCP.

- [PostOnce Help Center](https://docs.postonce.to/help/index.md): Answers for connecting social accounts, setting up automatic cross-posting workflows, scheduling posts, fixing failed posts, and managing your PostOnce plan.
- [Set up your first workflow](https://docs.postonce.to/help/getting-started.md): Connect a source and a destination account, create a PostOnce workflow, and check that your next post is copied automatically. Takes about five minutes.
- [Connect your social accounts](https://docs.postonce.to/help/connect-accounts.md): How to connect Instagram, TikTok, YouTube, Facebook Pages, LinkedIn, X, Threads, Bluesky, Pinterest and Google Drive to PostOnce, remove an account, and how many accounts each plan allows.
- [Reconnect an account](https://docs.postonce.to/help/reconnect-an-account.md): Why a social account needs reconnecting in PostOnce, what happens to your workflows while it's disconnected, and how to reconnect Instagram, Facebook, TikTok, YouTube, LinkedIn, X, Threads, Bluesky or Pinterest.
- [Let clients connect their accounts](https://docs.postonce.to/help/client-invite-links.md): Send a PostOnce invite link so a client can connect their Instagram, TikTok, YouTube, Facebook or other accounts to your PostOnce account without sharing their login.
- [Platforms at a glance](https://docs.postonce.to/help/platform-rules.md): Compare what PostOnce can copy from and publish to on Instagram, TikTok, YouTube, Facebook, LinkedIn, X, Threads, Bluesky and Pinterest: content types, caption limits, video lengths and daily caps.
- [Using Instagram with PostOnce](https://docs.postonce.to/help/platforms/instagram.md): Connect an Instagram Business or Creator account to PostOnce, copy Reels, carousels and Stories to other platforms, and publish to Instagram automatically. Limits, settings and errors.
- [Using TikTok with PostOnce](https://docs.postonce.to/help/platforms/tiktok.md): Connect TikTok to PostOnce, copy TikTok videos and photo posts to other platforms, and publish to TikTok with privacy, disclosure and draft options. Daily limits, settings and errors.
- [Using YouTube with PostOnce](https://docs.postonce.to/help/platforms/youtube.md): Connect a YouTube channel to PostOnce, copy YouTube Shorts and videos to other platforms, and publish videos to YouTube as Shorts or regular videos. Limits, titles and errors.
- [Using Facebook Pages with PostOnce](https://docs.postonce.to/help/platforms/facebook.md): Connect Facebook Pages to PostOnce, copy Page posts and Stories to other platforms, and publish text, photos and Reels to your Pages. Page picker, limits and errors.
- [Using LinkedIn with PostOnce](https://docs.postonce.to/help/platforms/linkedin.md): Connect a LinkedIn profile or Company Pages to PostOnce, copy Company Page posts to other platforms, and publish text, images and video to LinkedIn. Limits and errors.
- [Using X (Twitter) with PostOnce](https://docs.postonce.to/help/platforms/x.md): Connect X to PostOnce, copy your X posts to other platforms, and publish to X. Daily post and link limits, Premium length limits, account restrictions and errors.
- [Using Threads with PostOnce](https://docs.postonce.to/help/platforms/threads.md): Connect Threads to PostOnce, copy Threads posts to other platforms, and publish text, images, videos and carousels to Threads. Caption length options and errors.
- [Using Bluesky with PostOnce](https://docs.postonce.to/help/platforms/bluesky.md): Connect Bluesky to PostOnce with an app password, copy Bluesky posts to other platforms, and publish text, images and video to Bluesky. Limits and errors.
- [Using Pinterest with PostOnce](https://docs.postonce.to/help/platforms/pinterest.md): Connect Pinterest to PostOnce, copy your Pins to other platforms, and publish image and video Pins automatically. Boards, titles, limits and errors.
- [Back up posts to Google Drive](https://docs.postonce.to/help/platforms/google-drive.md): Use Google Drive as a PostOnce workflow destination to save a copy of every post's media and caption. Folder structure, settings, and what happens when Drive disconnects.
- [Workflows: automatic cross-posting](https://docs.postonce.to/help/workflows.md): How PostOnce workflows copy posts from one account to many, what the workflow page and settings tabs do, and how to pause, edit or delete a workflow.
- [Repost your existing posts on a schedule](https://docs.postonce.to/help/repost-existing-posts.md): Import your past Instagram, TikTok, YouTube or other posts into a PostOnce workflow and republish them on a daily schedule, to new platforms or the same account. Order, times, recycling and full sync.
- [Captions for each platform](https://docs.postonce.to/help/captions.md): Adjust captions per destination in PostOnce: remove comment and DM prompts, rewrite captions with AI, add custom text, remove @mentions, and how line breaks, hashtags and links are handled on each platform.
- [Filters, duplicates and video quality](https://docs.postonce.to/help/filters-and-duplicates.md): Choose which posts a PostOnce workflow copies: hashtag and keyword filters, content types, skipping low-quality videos, skipping duplicate videos, and running a full history sync.
- [How fast posts publish](https://docs.postonce.to/help/publishing-timing.md): How often PostOnce checks each platform for new posts, what Check now does, the difference between Immediately and On the schedule, and how to set time between posts on an account.
- [Create and schedule a post](https://docs.postonce.to/help/create-and-schedule-posts.md): Write one post in PostOnce and publish it to Instagram, TikTok, YouTube, Facebook, LinkedIn, X and more, now or at a scheduled time, with a different caption for each account.
- [Manage scheduled posts and drafts](https://docs.postonce.to/help/manage-scheduled-posts.md): See upcoming PostOnce posts in a calendar or list, change their time or text, cancel them, handle posts that need rescheduling, and keep drafts. Includes what each post status means.
- [Analytics: see how each video performs](https://docs.postonce.to/help/analytics.md): See views, likes, comments, shares and engagement for every video across TikTok, Instagram, YouTube and Facebook in PostOnce, including posts you made directly on each platform.
- [Import images from Google Drive, Dropbox and Canva](https://docs.postonce.to/help/import-media.md): Add an image to a PostOnce post straight from Google Drive, Dropbox or Canva. Supported files, size limits and fixes for import errors.
- [Connect an AI assistant to PostOnce](https://docs.postonce.to/help/connect-ai-assistant.md): Use Claude, ChatGPT, Grok, Cursor, Codex or any MCP client to publish posts and manage cross-posting workflows in PostOnce. Which assistants sign in directly and which need an API key.
- [Fix publishing problems](https://docs.postonce.to/help/troubleshooting.md): Why a PostOnce post failed, was skipped or didn't publish, and how to fix it. Find your error message, reconnect accounts, and fix paused publishing.
- [Missing, late or duplicate posts](https://docs.postonce.to/help/missing-or-duplicate-posts.md): Why a PostOnce workflow didn't copy a new post, why a post is late, and why a post appeared twice. Step-by-step checks for Instagram, TikTok, YouTube and other sources.
- [Video quality, sound and thumbnails](https://docs.postonce.to/help/video-quality-and-sound.md): Why a cross-posted video looks lower quality, has no sound, has bars around it or a different cover in PostOnce, and how to fix it on TikTok, Instagram, YouTube, Facebook and other platforms.
- [Plans and the free trial](https://docs.postonce.to/help/plans-and-billing.md): PostOnce Creator, Pro and Agency plans and prices, what the 7-day free trial includes, what happens when it ends, and how to upgrade or downgrade.
- [Billing, invoices and refunds](https://docs.postonce.to/help/billing-and-refunds.md): Update your card, download PostOnce invoices, cancel your subscription, get a refund within 7 days, and fix a failed payment or an unexpected charge.
- [Sign in and account settings](https://docs.postonce.to/help/sign-in-and-account.md): Sign in to PostOnce with Google or an email code, fix sign-in problems, choose which emails you receive, set your timezone, and change your account email.
- [Security and your data](https://docs.postonce.to/help/security-and-data.md): What PostOnce stores when you connect social accounts, how to revoke access, how PostOnce uses AI, and how to delete your PostOnce account and data.
- [Affiliate program](https://docs.postonce.to/help/affiliate-program.md): Earn 30% commission for 12 months on every customer you refer to PostOnce. Get your link, track clicks and earnings, and see payout terms.
- [Introduction](https://docs.postonce.to/introduction.md): Get started with the PostOnce Public API.
- [Authentication](https://docs.postonce.to/getting-started/authentication.md): Authenticate requests to the PostOnce Public API with dashboard-generated API keys.
- [Response format](https://docs.postonce.to/getting-started/response-format.md): Understand the standard success and error envelopes used by the PostOnce Public API.
- [Data structures](https://docs.postonce.to/getting-started/data-structures.md): Learn the main objects returned by the PostOnce Public API.
- [Rate limits](https://docs.postonce.to/getting-started/rate-limits.md): Understand plan-based request limits and product limits in the PostOnce Public API.
- [Errors](https://docs.postonce.to/getting-started/errors.md): Understand the PostOnce Public API response envelope and common error codes.
- [Create your first post](https://docs.postonce.to/guides/create-your-first-post.md): Publish one logical post to multiple connected accounts with the PostOnce Public API.
- [Schedule a post](https://docs.postonce.to/guides/schedule-a-post.md): Schedule a future post with the PostOnce Public API.
- [Create a workflow](https://docs.postonce.to/guides/create-a-workflow.md): Create a cross-post workflow with the PostOnce Public API.
- [Save RSS updates as drafts](https://docs.postonce.to/guides/rss-to-draft.md): Create reviewable PostOnce drafts from feed items with the API or native Zapier action, using stable retry keys.
- [Partner integration](https://docs.postonce.to/guides/partner-integration.md): Let your own users connect YouTube, TikTok and Instagram and publish from your product through PostOnce.
- [PostOnce MCP](https://docs.postonce.to/mcp/docs.md): Connect an MCP client to PostOnce, discover your social accounts, publish posts and inspect delivery, or create automatic crossposting workflows.
- [List accounts](https://docs.postonce.to/api-reference/list-accounts.md): Returns all social accounts owned by the API key profile, including disconnected accounts. Partner accounts also receive `external_user_id` on each account and can filter by it.
- [Connect account](https://docs.postonce.to/api-reference/connect-account.md): Computes a five-minute browser authorization URL bound to the authenticated profile without connecting or changing an account. Open the returned URL in a separate browser step to authorize the provider; then list accounts to verify connection. Depending on platform, the browser uses provider OAuth o…
- [Disconnect account](https://docs.postonce.to/api-reference/disconnect-account.md): Removes PostOnce access to an owned social account. The account is disconnected with its credentials cleared (the response returns deleted=false and disconnected=true); its posts and history are kept, and reconnecting the same account restores posting. Farcaster, Nostr, and Telegram records are also…
- [Create upload URL](https://docs.postonce.to/api-reference/create-upload-url.md): Creates a signed upload URL and media_id. Upload raw file bytes with PUT to data.upload.signedUrl, then call get_media with that media_id and pass the returned data.public_url as media[].url when creating a post or draft. URL creation alone does not upload bytes. Treat the signed URL as a temporary…
- [Get media](https://docs.postonce.to/api-reference/get-media.md): Resolves a previously returned `media_id` into its storage path and public URL.
- [List drafts](https://docs.postonce.to/api-reference/list-drafts.md): Lists unscheduled drafts owned by the authenticated API-key profile.
- [Create draft](https://docs.postonce.to/api-reference/create-draft.md): Saves content and optional media or destinations without publishing or scheduling it. Reuse an Idempotency-Key when retrying.
- [Get draft](https://docs.postonce.to/api-reference/get-draft.md): Returns one draft owned by the authenticated API-key profile.
- [Update draft](https://docs.postonce.to/api-reference/update-draft.md): Updates, archives, restores, or marks a draft ready using updated_at as a compare-and-swap version.
- [List posts](https://docs.postonce.to/api-reference/list-posts.md): Lists the authenticated profile's posts, newest first: posts created through the API or dashboard, and posts published by workflows (origin `workflow`). Workflow posts are read-only.
- [Create post](https://docs.postonce.to/api-reference/create-post.md): Creates one logical post that can target multiple connected accounts. Include `publish_at` to schedule it instead of sending immediately.
- [Get post](https://docs.postonce.to/api-reference/get-post.md): Returns one aggregate post with per-target delivery state.
- [Update post](https://docs.postonce.to/api-reference/update-post.md): Updates a scheduled post before it runs.
- [Delete post](https://docs.postonce.to/api-reference/delete-post.md): Cancels a scheduled or still-pending post without deleting its aggregate record or already published social content. This is functionally equivalent to cancel_post.
- [Publish now](https://docs.postonce.to/api-reference/publish-now.md): Starts publishing a scheduled post immediately and returns the aggregate in processing state.
- [Cancel post](https://docs.postonce.to/api-reference/cancel-post.md): Cancels a scheduled or still-pending post without deleting its aggregate record or already published social content.
- [List workflows](https://docs.postonce.to/api-reference/list-workflows.md): Lists all workflows owned by the authenticated profile.
- [Create a workflow](https://docs.postonce.to/api-reference/create-a-workflow.md): Creates a future-content cross-post workflow from one source account to one or more target accounts. Use `settings.content_filters` to limit which future posts are eligible.
- [Get workflow](https://docs.postonce.to/api-reference/get-workflow.md): Returns one workflow by ID.
- [Update a workflow](https://docs.postonce.to/api-reference/update-a-workflow.md): Updates a future-content workflow configuration, including activation state, target accounts, and optional `settings.content_filters`.
- [Delete a workflow](https://docs.postonce.to/api-reference/delete-a-workflow.md): Deletes a workflow and any queued workflow items linked to it.
- [v1 changelog](https://docs.postonce.to/changelog/v1.md): Release notes for the PostOnce Public API v1.

## OpenAPI Specs

- [public-api](/openapi/public-api.yaml)


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