Guide

Scheduling posts for later publish

Set scheduleAt to a future UTC timestamp on POST /api/v1/posts to queue a Social Relay job. Schedule create debits a small token fee; publish_leg tokens are charged when the scheduled job runs for each network.

← GuidesPublishingUpdated 2026-08-10

In short

Set scheduleAt to a future UTC timestamp on POST /api/v1/posts to queue a Social Relay job. Schedule create debits a small token fee; publish_leg tokens are charged when the scheduled job runs for each network.

Creating a scheduled post

Include scheduleAt as ISO-8601 UTC. Omit or null means publish as soon as workers accept the job. Platforms must still be connected for the profile when the job fires.

Billing timing

posts.schedule_create costs 2 tokens when the scheduled post is accepted. Each network still costs posts.publish_leg (10) at fire time.

Operations

A timer worker on the API host picks due posts. Prefer webhooks for terminal status instead of tight polling. Delete/cancel before fire when supported for scheduled jobs.