publishedScheduling for AI agents
The schedule keeps running after your agent disconnects.
Your agent hands off finished videos and exact UTC times once. Postdom holds the queue, applies your saved rules, and returns what happened.
missed_schedule If execution starts more than 15 minutes late, Postdom stops the post instead of publishing late.
The durable queue
One handoff replaces daily posting.
The caller does not need to stay awake, keep a tab open, or return at publish time. Scheduled work remains in the workspace until it runs or returns a clear state.
- 01
The agent plans.
It selects connected account IDs, finished media, a caption, and an exact UTC time.
- 02
Postdom records.
The request becomes scheduled work inside the workspace rather than a timer inside the agent session.
- 03
The rules apply.
Account authority, plan bounds, connection state, and pause are checked before provider handoff.
- 04
The outcome returns.
The agent reads the post and each destination instead of treating request acceptance as publication.
One exact time
Give the schedule a UTC target.
publish_video accepts an optional publish_at value in RFC 3339 UTC ending in Z. Omit it, and Postdom does not claim an exact scheduled time.
Open the publish_video referencepublish_video({
account_ids: [
"acct_instagram",
"acct_youtube",
"acct_tiktok"
],
media_handle: "pd_media_11111111-1111-4111-8111-111111111111",
caption: "Three moves that changed our launch",
publish_at: "2026-09-03T09:00:00Z",
plan_id: "22222222-2222-4222-8222-222222222222",
intent: "Publish the approved launch post"
})Late-work boundary
Late work stops.
No approval by the due time becomes missed_approval. Authorized execution that starts more than 15 minutes late becomes missed_schedule. Neither state silently publishes stale work.
missed_approvalNo authority
If required approval never arrived, the post stops before provider handoff.
execution windowExecution window
Authorized work may begin only while it is no more than 15 minutes late.
missed_scheduleHuman decision
Postdom stops and returns the exact state instead of silently publishing stale work.
A human chooses publish now, reschedule, or cancel.Read the exact run states
Connected accounts
One time. Every selected destination.
The same scheduled request can target multiple connected accounts. Each destination keeps its own publication answer after the due time passes.
See how destination outcomes workpublishedfailedFor AI agents
Schedule from the live contract.
Call get_workspace_status first, inspect the connected schema, use exact account IDs, and provide publish_at only when the human or plan supplied an explicit UTC time.
Never guess a timezone, widen authority, rename a returned state, or claim an exact schedule when publish_at was omitted.Scheduling FAQ
Scheduling questions
Can an AI agent schedule social media posts automatically?01
Yes. A connected agent can submit finished short-form video with selected account IDs and an optional exact UTC publish_at value. Postdom stores the scheduled work and executes it inside the workspace's saved authority.
Does the agent need to stay online until the post publishes?02
No. The scheduled post remains in the Postdom workspace after the calling agent disconnects. The agent can return later and read the exact post and destination states.
What happens if approval is not complete by the scheduled time?03
Postdom enters missed_approval and does not create a late provider handoff. A human can publish now, reschedule, or cancel.
What happens if Postdom cannot start an authorized post on time?04
If authorized execution starts more than 15 minutes after the stored time, Postdom enters missed_schedule instead of publishing late. A human then chooses publish now, reschedule, or cancel.
Does every selected account need the same authority level?05
No. Each connected account keeps its own human-set mode. When one request targets several accounts, the strictest selected mode governs the whole request; Postdom does not split it into partially authorized publishes.
Do scheduled posts always need an approved plan?06
No. The required authority path depends on the selected accounts' configured modes. Some requests require manual or per-post review, some use an approved plan, and bounded account policy can authorize eligible work.
Which short-form destinations can an agent schedule through Postdom?07
The current destination contract covers TikTok, Instagram Reels, YouTube Shorts, LinkedIn, Facebook Reels, X, Snapchat Spotlight, Threads, and Bluesky. Provider requirements and measurement availability remain specific to each destination.
Put the week in motion
Let the agent plan. Let Postdom keep time.
Create a workspace, connect the accounts, and give your agent a durable place to put the schedule.
Create a free workspace