Every post endpoint can publish immediately or later. You pick the timing mode per request.
Publish now
The default. Omit any scheduling field and the post goes out immediately.
Schedule for an exact time
Add scheduled_at (ISO-8601) and an optional timezone (IANA name). MADIAD Hub holds the post and publishes it at that moment.
-F "scheduled_at=2026-06-01T15:00:00Z" \
-F "timezone=Asia/Ho_Chi_Minh"
scheduled_at is read as UTC when it ends in Z. Provide timezone to resolve local wall-clock times and daylight saving correctly.- Scheduled posts return
status: "scheduled". They publish later — track the outcome with webhooks.
- You can schedule up to one year ahead.
Use a recurring queue
Instead of an exact timestamp, drop the post into the profile’s queue with add_to_queue=true. It publishes in the next open slot of your preconfigured posting schedule.
scheduled_at and add_to_queue are mutually exclusive — set one or the other, never both.
Cancel or reschedule
A scheduled post can be canceled before it publishes — from the dashboard, or via the API while its status is still scheduled. 
