# PostOnce API

> Automate social publishing, scheduling, and cross-post workflows with the PostOnce Public API.

- [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. Most account records are deleted; Farcaster, Nostr, and Telegram records remain disconnected and disabled with credentials cleared. Farcaster signer revocation requires a separate provider step; Nostr remote-signer logout is best effort; @PostOnceB…
- [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.