---
title: "1Post docs: composer, scheduling, API, webhooks, MCP"
url: "https://get1post.com/docs.md"
canonical_url: "https://get1post.com/docs"
last_updated: "2026-10-26"
type: "index"
summary: "Documentation for 1Post: how the composer, scheduling and approvals work, plus the API reference, webhooks, the MCP server and every error code."
related: ["https://get1post.com/guides.md", "https://get1post.com/tools.md", "https://get1post.com/pricing.md"]
---

# 1Post docs: composer, scheduling, API, webhooks, MCP

Documentation for 1Post: how the composer, scheduling and approvals work, plus the API reference, webhooks, the MCP server and every error code.

Everything you need to use 1Post, from the first post to the API. Read how the composer and scheduling work, how approvals and review links keep a team in step, and how to post from your own code or an assistant. Search the docs, or open the API reference and the error codes.

Start with the [quickstart](https://get1post.com/docs/quickstart.md) if you build, or the [composer](https://get1post.com/docs/composer.md) if you write posts.

## Start here

- [Quickstart: your first post from code](https://get1post.com/docs/quickstart.md): Create a key, find your account ids and send your first post with one request. A short path from sign-up to a scheduled post through the 1Post API.
- [Concepts: workspaces, accounts, posts and destinations](https://get1post.com/docs/concepts.md): The five objects behind 1Post: the workspace, the connected account, the post, its destinations and the slot. Learn what each one is and how they relate.
- [Workspaces, members and roles](https://get1post.com/docs/workspaces-and-roles.md): How a workspace separates brands and clients, which roles exist and what each role may do, including which roles approve posts.
- [Connect and manage accounts](https://get1post.com/docs/connect-accounts.md): Connect a network account by redirect or with its own details, pick the page or channel it posts to, and disconnect it without losing history.
- [Invite links: let a client connect their own account](https://get1post.com/docs/invite-links.md): Send a client a link that connects their own account to your workspace without a 1Post login, and how long it lasts.

## Composer and media

- [The composer: one post, a version for every network](https://get1post.com/docs/composer.md): How the composer works: write once, see a live preview for each network, tailor the text per network, add parts and a first comment.
- [Previews, limits and how each network counts](https://get1post.com/docs/previews-and-limits.md): Why a post can be fine on one network and refused on another, how 1Post checks limits before sending and where to look up each rule.
- [Media: uploads, imports and the library](https://get1post.com/docs/media.md): Upload files straight to storage, import from a public address, keep favourites in the media library and what happens before a post can use a file.
- [Sets, signatures and tags](https://get1post.com/docs/sets-signatures-tags.md): Save the accounts you post to together, reuse blocks of text and tag posts so you can filter the calendar and the API.

## Scheduling

- [Scheduling: a time, a slot or now](https://get1post.com/docs/scheduling.md): The three ways to send a post, how time zones are read, how far ahead you can schedule and what changing a scheduled post does.
- [Slots and the queue](https://get1post.com/docs/slots-and-queue.md): Set weekly posting times, let new posts take the next free slot and move or delete slots without losing the posts that use them.
- [The calendar: month, week and list](https://get1post.com/docs/calendar.md): See every scheduled and published post by day, drag a post to another day and read each destination's state at a glance.
- [Failures, retries and unknown outcomes](https://get1post.com/docs/reconnect-and-failures.md): What failed and unknown mean for a destination, how to retry safely and how to attach a post that went out when the answer was lost.
- [Repeat and follow-up rules](https://get1post.com/docs/repeat-rules.md): Rules that repeat or answer your own post with fixed text you wrote once it reaches a like count, and how to switch them on and off.

## Teams and approvals

- [Approvals: submit, approve and request changes](https://get1post.com/docs/approvals.md): How posts move through review: a contributor submits, a reviewer approves or sends back with a note, and which roles may approve.
- [Review links: preview and approve without a login](https://get1post.com/docs/review-links.md): Send a client a link to preview posts, comment and approve them with no 1Post account, how long it works and how to revoke it.
- [Comments on posts](https://get1post.com/docs/comments-on-posts.md): Leave notes on a post for your team, read what a client wrote on a review link and keep both with the post.

## Results and inbox

- [Results: checkpoints, metrics and summaries](https://get1post.com/docs/analytics.md): How 1Post collects each post's results at checkpoints, what the summary shows and how long results are kept for each plan.
- [The inbox: comments and replies](https://get1post.com/docs/inbox.md): Read the comments your audience leaves on your posts, mark them open or done, assign them and send your own reply from the right account.
- [Notifications and the audit trail](https://get1post.com/docs/notifications-and-audit.md): The notification centre and per-kind email settings, and the audit trail that records who or what changed your workspace.
- [Plan limits and monthly usage](https://get1post.com/docs/billing-and-usage.md): See what your plan includes, how much of each monthly allowance this month has used and what happens when one runs out.

## API

- [API authentication and keys](https://get1post.com/docs/api-authentication.md): How keys work: bound to a workspace and a member, scoped to read or write, sent as a bearer token and revoked when a member leaves.
- [Idempotency: retry without posting twice](https://get1post.com/docs/api-idempotency.md): Send an Idempotency-Key on a write and a retry returns the first answer for 24 hours instead of creating a second post.
- [Rate limits and request size](https://get1post.com/docs/api-rate-limits.md): How many requests a key and an address may send, how the rate_limited error tells you when to retry and the size limit on bodies.
- [Creating and changing posts with the API](https://get1post.com/docs/api-posts.md): The request shape for POST /v1/posts: text and parts, accounts with per-account overrides, first comments, timing and what the reply holds.
- [Media uploads with the API](https://get1post.com/docs/api-media-uploads.md): Request a signed upload address, send the file straight to storage with its headers and use the media id in a post.
- [The free tools over the API](https://get1post.com/docs/free-tools-api.md): Run the 1Post free tools without a key: check_post, split_thread, platform_limits and build_utm_link, over REST or the MCP server.
- [API reference](https://get1post.com/docs/api.md): Every 1Post API route with its method, path, what it does, the key scope and role it needs, its parameters and its request body fields. 128 operations.
- [Error codes](https://get1post.com/docs/errors.md): Every error code the 1Post API returns, what it means and what to do: one envelope with a stable code, a message, a fix and a request id.

## Webhooks and MCP

- [Webhooks: signed events when something happens](https://get1post.com/docs/webhooks.md): Add an endpoint, choose which events and accounts it covers, verify the Standard Webhooks signature and send a test event.
- [The MCP server](https://get1post.com/docs/mcp.md): Connect an assistant to 1Post over MCP: free tools with no key, every tool with a key or OAuth, and confirmation for actions that publish.
- [MCP sign-in with OAuth](https://get1post.com/docs/mcp-oauth.md): How an MCP client registers, signs in with PKCE, gets a token for one workspace and how a person revokes the connection.

## Questions

**Where do I start?**

The quickstart sends a first post from code in a few requests. The concepts page explains the objects behind it.

## Related

- [How-to guides for scheduling social media posts](https://get1post.com/guides.md)
- [Free social media tools: counters, previews and more](https://get1post.com/tools.md)
- [1Post pricing: plans from $29 a month](https://get1post.com/pricing.md)