Book a callSign inSign up
FeaturesWorkflowPlatformsFree toolsChangelogTeams and agenciesDevelopersUse casesDocsGuidesCompareAlternativesGlossaryDataPricingFAQBook a callSign inStart a trial
API

Creating and changing posts with the API

POST /v1/posts takes accounts and either text or parts. Each account can be an id or an object with its own text, settings, first comment, time and link placement. Without schedule_at, publish_now or use_next_free_slot the post is saved and not sent. The reply lists the post and each destination.

Also:QuickstartScheduling1Post API reference

Updated 2026-10-26

The body

  • accounts: 1 to 100 ids or objects. An object can carry its own parts, settings, first_comment, scheduled_at and link_placement.
  • text or parts: parts is 1 to 100 items, each with text, up to 20 media ids and an optional delay in minutes.
  • schedule_at, publish_now or use_next_free_slot: pick how it goes out.

Changing it

PATCH /v1/posts/{id} changes only what you send. parts replaces the text and media; accounts patches destinations or adds them; remove_accounts drops some. A post that has already gone out can only be moved.

Send an Idempotency-Key with every create.

Try it

Start a trial

7-day trial for $1. Connect your accounts and schedule a week of posts in one sitting.

Start a trial
Free in your browser

Free tools

Count characters the way each network does, split threads and preview posts. No account needed.

Open the tools
For builders

API and MCP

Post to every network from your own code or assistant with one key, signed webhooks and idempotent requests.

See the API

Questions

How do I post different text to two networks?

Give each account an object with its own parts, or patch a destination by account_id after creating the post.

Schedule Bluesky posts: formats, limits, setupBluesky specs and limits: text, media, daily capFree character counter for every social networkHow to cross-post to Bluesky and Mastodon at once1Post vs Typefully: price, networks, APISocial media posting limits by network, dated
Quickstart: 1Post docsScheduling: 1Post docs1Post API reference: every route, key and role1Post docs: composer, scheduling, API, webhooks, MCP

Get this week’s posts scheduled

Connect your accounts, write once and let 1Post publish on time while you get on with the rest of your day.

Start a 7-day trial for $1See pricing