Posts

Posts are the core publishing unit. Write once, target multiple platforms, and Autoposting handles per-platform delivery, retries, and status tracking independently — so a failure on one platform never blocks another.

Status Lifecycle

Status	Description
`draft`	Saved, not queued for publishing
`scheduled`	Queued with a future `scheduledAt` datetime
`validating`	Token health, media, and platform constraints being checked
`validated`	All checks passed; handed to platform adapters
`publishing`	Platform publish jobs running
`published`	All targeted platforms reported success
`partial`	At least one platform succeeded, at least one failed
`failed`	All targeted platforms failed
`billing_hold`	Paused — subscription suspended
`render_pending`	Waiting for a clip render to complete
`archived`	Excluded from all publishing and analytics

Create and Schedule a Post

curl -X POST https://app.autoposting.ai/api-proxy/posts \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "brandSlug": "brand_slug",
    "text": "Excited to share our latest update!",
    "platforms": ["x", "linkedin"],
    "scheduledAt": "2025-06-15T14:00:00Z"
  }'

const res = await fetch("https://app.autoposting.ai/api-proxy/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    brandSlug: "brand_slug",
    text: "Excited to share our latest update!",
    platforms: ["x", "linkedin"],
    scheduledAt: "2025-06-15T14:00:00Z",
  }),
});
const { data } = await res.json();

Omit scheduledAt to publish immediately — the post enters validating directly.

Platform Options

X (Twitter)
LinkedIn
Instagram
Threads
YouTube

Publish threads by passing the thread array — each item becomes a chained reply.

{
  "text": "1/ Here's everything we shipped this quarter.",
  "thread": ["2/ First: faster scheduling.", "3/ Second: AI rewrite."],
  "platforms": ["x"]
}

Supports polls via a poll object with options (2–4 strings) and durationMinutes.

Up to 20 images per carousel post. Character limit: 3,000 (personal) or 700 (org pages).

{ "text": "Proud to announce...", "platforms": ["linkedin"] }

Option	Description
`thumbOffsetMs`	Thumbnail frame offset in milliseconds
`shareToFeed`	Share Reel to feed as well
`coverUrl`	Custom cover image URL
`collaborators`	Up to 3 collaborator usernames

Option	Values	Description
`replyToId`	string	Reply to an existing Threads post
`replyControl`	`everyone`, `accounts_you_follow`, `mentioned_only`	Who can reply

Option	Max	Description
`title`	100 chars	Required for YouTube posts
`description`	5,000 chars	Video description
`privacyStatus`	—	`public`, `private`, or `unlisted`
`tags`	—	Array of tag strings
`madeForKids`	—	COPPA compliance flag

Scheduling

Pass an absolute ISO 8601 datetime in scheduledAt. Schedules are evaluated in the brand’s configured timezone but stored in UTC.

A cron runs every minute to move scheduled posts whose scheduledAt has passed into validating. Expired tokens cause failure at validation — not at publish time.

Retry Failed Posts

When a post is failed or partial, retry only the failed platforms without recreating the post.

curl -X POST https://app.autoposting.ai/api-proxy/posts/:id/retry \
  -H "Authorization: Bearer sk_your_api_key"

AI Tools

Rewrite — adjust tone or improve quality without changing meaning:

curl -X POST https://app.autoposting.ai/api-proxy/posts/:id/rewrite \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "tone": "professional", "platform": "linkedin" }'

Score — rate text for likely engagement. Returns hook, retention, clarity, visual (each 0–100) plus viralityScore.

Media Attachments

Upload files via POST /media/presign to get a presigned URL, then reference the returned URL in your post’s media array.

Platform constraints differ: X allows up to 4 images or 1 video; Instagram Reels require video; YouTube requires exactly 1 video. Posts violating these constraints fail at validating.

Platforms

Character limits, media rules, and OAuth for each platform.

Brands

Every post belongs to a brand with its own connected accounts.

Clips

Publish rendered video clips directly as scheduled posts.

Webhooks

Get notified when posts publish, fail, or change status.

Getting Started

Core Concepts

Status Lifecycle

Create and Schedule a Post

Platform Options

Scheduling

Retry Failed Posts

AI Tools

Media Attachments

Platforms

Brands

Clips

Webhooks

​Status Lifecycle

​Create and Schedule a Post

​Platform Options

​Scheduling

​Retry Failed Posts

​AI Tools

​Media Attachments

Platforms

Brands

Clips

Webhooks

Status Lifecycle

Create and Schedule a Post

Platform Options

Scheduling

Retry Failed Posts

AI Tools

Media Attachments