Social Calendar
draftPost
Draft Post
Draft a new social post on a Space's content calendar: caption, optional title/first comment, optional media from the Space's Files, and an optional scheduled slot.
Arguments
spacestringrequiredSpace name or id that owns this calendar (e.g. Pure Pastry).captionstringrequiredThe caption that ships to the channel.channelstringoptionalWhich channel this post ships to. Connected Instagram and TikTok accounts publish automatically.titlestringoptionalInternal board label: never shown on the channel.firstCommentstringoptionalOptional first comment, posted under the caption.mediaFileIdsstring[]optionalCloud File ids for the photos/video this post carries.scheduledAtstringoptionalISO timestamp for the slot, e.g. 2026-09-01T09:00:00Z.timezonestringoptionalIANA zone the slot was picked in (e.g. Europe/Lisbon). Required when scheduledAt is set.
Returns
The registry does not declare a return shape.
Ask for it
The Cloud routes these requests to this verb.
- draft an Instagram post about X
- add a post to the calendar for Friday
- write a caption for the new pastry
Pair it with
The verbs that finish the job.