Developer & API

Scheduled Post

Also known as: Queued post, Scheduled publication

5 min read·Updated 2026-05-06

Quick definition

A scheduled post is a piece of content queued in advance to publish at a specific future date and time, without requiring the author to be online when it goes live. Most modern social platforms support native scheduling; third-party APIs (CodivUpload, Buffer, Ayrshare, Postiz) wrap and extend it across all 11 major platforms.

Contents
  1. 1. What is a scheduled post?
  2. 2. Why scheduling matters for reach
  3. 3. Native vs API scheduling
  4. 4. Common scheduling patterns
  5. Per-platform table
  6. API example
  7. Common pitfalls
  8. Tips
  9. FAQ

What is a scheduled post?

A scheduled post is content authored now but published later — the author writes the caption, attaches media, picks a future date and time, and the platform (or third-party tool) handles delivery at that moment. The mechanic exists because most audiences are online at hours when most creators are not — for example, your TikTok audience peaks at 9pm but you finished editing the video at 6am. Scheduling decouples authoring time from publish time, letting you ship at the moment your audience is most likely to engage.

Why scheduling matters for reach

Algorithms weigh first-30-minute engagement velocity heavily. A post published at 3pm on Tuesday when your audience is at work earns less velocity than the same post at 9pm when they're scrolling. Even a perfect post earns mediocre reach if it lands in a quiet hour. Scheduling lets you author whenever it's convenient and dispatch when reach is highest.

For multi-platform creators the math compounds. Each of your 11 platforms has a different optimal hour. Without scheduling, you're either online at midnight blasting posts (impractical) or accepting suboptimal reach on 9 platforms while you nail one. Scheduled posts solve this completely — author once, schedule each platform for its own peak.

Native vs API scheduling

Every major platform now offers native scheduling for verified or business accounts: Instagram (via Meta Business Suite, up to 75 days out), TikTok (up to 10 days), YouTube (up to 6 months), LinkedIn (up to 90 days), X (up to 18 months for X Premium), Facebook Pages (up to 75 days). Native scheduling is free and works fine for single-platform users. The friction is multi-platform — a creator on 5 platforms ends up in 5 different scheduling UIs with 5 different conventions.

Third-party APIs solve this with a single endpoint. CodivUpload's POST /v1/posts accepts a scheduled_date field in ISO 8601 UTC and dispatches across all 11 platforms in one call, respecting each platform's own scheduling backend underneath. Same authentication, same payload shape, same webhook callbacks regardless of platform.

Common scheduling patterns

Three patterns dominate. (1) Same-time-everywhere — publish identical timestamp across all platforms. Simplest, often suboptimal because each platform peaks at different hours. (2) Per-platform optimal time — schedule each platform separately at its own peak from analytics. Best ROI but requires either a smart scheduler or manual coordination. (3) Stagger by minutes — publish to all platforms within a 5-minute window with each platform's optimal hour. Compromise that captures most of the per-platform benefit without complete coordination overhead.

Native scheduling horizon by platform (2026)

PlatformMax future dateNotes
Instagram75 daysVia Meta Business Suite; account must be Business or Creator
TikTok10 daysNative scheduler in Studio; limited horizon vs other platforms
YouTube6 monthsSchedule unlisted upload to publish later
LinkedIn90 daysPersonal and Page accounts; via native scheduler
X / Twitter18 months (X Premium)Free tier limited to 24 hours
Facebook (Pages)75 daysPages only; personal profiles cannot schedule natively
Pinterest14 daysNative scheduler
BlueskyNot supported nativelyUse third-party (CodivUpload supports it via queue)
ThreadsNot yet supported nativelyComing via Meta Business Suite

Schedule a multi-platform post via REST API

json

// POST /v1/posts
// scheduled_date in UTC ISO 8601 — no timezone math required
{
  "profile_name": "main",
  "platforms": ["tiktok","instagram","youtube","linkedin"],
  "post_type": "reel",
  "media_urls": ["https://cdn.example.com/video.mp4"],
  "description": "Behind the scenes of build week.",
  "scheduled_date": "2026-05-08T14:00:00Z",   // 9am ET / 2pm UTC
  "tiktok_privacy_level": 0,
  "instagram_media_type": "REELS"
}

// Response includes a post_id you can query later or subscribe via webhook
{
  "id": "post_k8m2v9x1",
  "status": "scheduled",
  "scheduled_for": "2026-05-08T14:00:00Z",
  "platforms": [
    { "platform": "tiktok",    "status": "queued" },
    { "platform": "instagram", "status": "queued" },
    { "platform": "youtube",   "status": "queued" },
    { "platform": "linkedin",  "status": "queued" }
  ]
}

Common pitfalls

  • ×Passing local time instead of UTC ISO 8601 — most common scheduling bug; always use UTC at the API layer
  • ×Scheduling beyond a platform's max horizon (e.g. TikTok's 10 days) — request will reject or silently truncate
  • ×Not subscribing to webhooks — polling the post status every 30 seconds wastes quota and ages tokens
  • ×Forgetting per-platform privacy flags — TikTok defaults to private, must set tiktok_privacy_level: 0 explicitly for public

Tips

  • Always pass scheduled_date as UTC ISO 8601 — let the scheduler handle timezone conversion server-side
  • Subscribe to webhook events for post.published / post.failed / post.token_expired — instant feedback without polling
  • Stagger per-platform timestamps by 1-5 minutes for optimal reach — same-second multi-platform looks like spam
  • Use the schedule horizon to plan campaigns — write a week's worth of content in one session, schedule for daily delivery

Frequently asked questions

What's the maximum date I can schedule a post for?+

Depends on the platform — TikTok caps at 10 days, Instagram and Facebook at 75 days, LinkedIn at 90 days, YouTube at 6 months, X at 18 months for Premium accounts. Third-party APIs respect each platform's native limit. CodivUpload's free plan caps at 7 days; paid plans (Starter and above) allow up to 75 days, matching the most-restrictive major platform.

Can I schedule the same post for different times on different platforms?+

Yes — that's actually the recommended pattern. Each platform's optimal hour differs (LinkedIn morning weekdays, Instagram evening, TikTok evening). CodivUpload's API lets you set a scheduled_date per platform via separate POST calls, or use the dashboard composer's per-platform time picker.

What happens if a scheduled post fails to publish?+

Modern APIs return a webhook event (post.failed) with the error reason — most commonly token_expired (the user's OAuth needs reconnecting), rate_limited, or content_policy_violation. The recommended pattern is to subscribe to the webhook in n8n / Slack / your app and surface failures to the responsible team for action. Polling for status is an antipattern.

Can I edit a scheduled post after queuing it?+

Yes via API or dashboard — DELETE the original scheduled post and POST a new one with corrected fields. Some platforms allow in-place editing of scheduled posts (Instagram, LinkedIn); others require delete-and-replace (TikTok). CodivUpload's API normalizes this — call PATCH /v1/posts/{id} and the underlying platform-specific edit semantics happen behind the scenes.

How is scheduling different from queuing?+

Scheduling pins a post to a specific date and time. Queuing puts a post into a 'next available slot' system where the scheduler picks the next open time from your settings (e.g. 'Mon-Fri 9am, 12pm, 5pm'). Most scheduling APIs support both — pick scheduling for campaign-specific timing, queuing for evergreen content drip.

Schedule across all 11 platforms in one API call

CodivUpload's REST API supports scheduled_date with per-platform overrides. Webhook callbacks for status. Free plan covers 10 scheduled posts/month — Starter ($20/mo) unlocks unlimited and full API access.

Try scheduling free

Read next

Related glossary terms

Back to all 209 glossary terms