for software developers
authenticated REST endpoints let your systems create drafts, inspect status, and trigger publish after human approval. integrates with TimeToPost drafts, scheduling, and monitoring for Instagram, TikTok, and X.
feature
the social media api provides authenticated REST endpoints to create, inspect, and manage posts at the organization scope. use the api to push drafts into TimeToPost, check draft status, update content metadata, and trigger publish actions once a draft is approved.
published content follows TimeToPost delivery paths to Instagram, TikTok, and X. drafts generated by TimeToPost features, including ideas, git commits, trends, or seo topics, can also be created or referenced through the api so your systems stay in sync.
security and limits
api access requires org-level authentication and role-based permissions. only accounts with the designated org role may create or manage organization posts through the endpoints.
access to the social media api is provided on TimeToPost s single plan. the platform enforces an approval queue. drafts created by the api remain pending until a human approver in your organization approves them. platform and third-party rate limits also apply and may affect publish timing.
developer workflow
authenticate with an org token and confirm the calling identity has post management rights. create a draft object with content, media references, and metadata. the api will store the draft and mark it pending in the shared approval queue.
use inspection endpoints to poll draft state. once an approver publishes the draft, TimeToPost schedules delivery at the account best time and pushes to the selected platform. your integration should handle status transitions and platform error responses for reliable retries.
integration points
the api integrates with TimeToPost content sources. drafts can originate from ideas, git commits, trend signals, or seo topics. TimeToPost s AutoSEO blog engine and MCP surface coexist with the api; note that MCP agents run without api keys and are a separate automation surface.
for live posting, TimeToPost delivers to Instagram, TikTok, and X. choose between publishing via api-triggered workflows or using agent-driven MCP flows depending on whether you need programmatic control or agent automation.
evaluation guide
confirm the api supports your must-have actions: create, read, update, delete drafts; inspect approval state; and trigger publish. verify org-level authentication and the required roles exist in your organization before development begins.
review the single approval queue behavior and plan inclusion. test error handling for platform rejections and account-level limits. if you rely on agent automation instead of programmatic control, consider the MCP surface where agents operate without api keys.
Questions for this workflow
yes. TimeToPost exposes authenticated REST endpoints to create, inspect, and manage posts at the organization scope. use the api to insert drafts, read status, and initiate publish actions once a human approver releases the draft.
all drafts enter a single approval queue regardless of origin. api-created drafts remain pending and will not publish until a human approver accepts them. the queue enforces manual approval to prevent accidental publishing.
published posts are delivered to Instagram, TikTok, and X. confirm account-level permissions and platform-specific constraints before sending media or scheduling complex posts.
api access is included on TimeToPost s single plan. the platform enforces role-based permissions and an approval queue. third-party platform rate limits and publishing policies also apply and may influence throughput and retry behavior.
Start with the workflow above, keep the human review gate, and adapt the cadence to the accounts you actually operate.
Start a review-first workflow