Posts
Create Post
Create or schedule a new post. Each social media platform has its own settings schema.
POST
Post type: now, schedule, or draft
The top-level type field controls when (and whether) the post is published:
| Value | Behaviour |
|---|---|
"now" | Publish immediately. date is ignored. |
"schedule" | Publish at the time given in date (ISO 8601). |
"draft" | Save as a draft. The post is created and stored against the integration but not scheduled or published. You can promote it to a real post later from the Postiz UI. |
Duplicating a post
There is no dedicated duplicate / clone endpoint. To copy an existing post, fetch it withGET /posts and submit the content as a new POST /posts request.
Before re-submitting, strip the server-managed fields from the fetched object — re-sending them either causes validation errors or, worse, accidentally updates the original. At minimum drop:
idand any nested post IDscreatedAt,updatedAt, and any other timestampsstate/status/releaseId(these are assigned by the scheduler)- Anything else the API didn’t ask you to provide when you originally created the post
type (now, schedule, or draft) and date, and POST the cleaned object.
Provider-Specific Settings
When creating posts, each social media platform requires different settings. Thesettings object must include a __type field that identifies the platform.
All 27 Supported Platforms
Platforms Without Custom Settings
These platforms only need the__type field:
threads, mastodon, bluesky, telegram, nostr, vk
Detailed Provider Settings
See the Provider Settings section for detailed schemas and examples for each platform.Authorizations
Your Postiz API key
Body
application/json
Post type
Available options:
draft, schedule, now Publish date in UTC ISO format
Whether to use short links
Order of posts
Interval between posts
Required if type is not 'draft'
__typexwho_can_reply_post(optional:community,made_with_ai,paid_partnership)linkedinlinkedin-pagefacebookurl)instagrampost_typeinstagram-standalonepost_typethreadsblueskymastodonwarpcastsubreddit[]for channels)nostrvk__typeyoutubetitle,typetiktokprivacy_level,duet,stitch,comment,autoAddMusic,brand_content_toggle,brand_organic_toggle,content_posting_method__typeredditsubreddit[](array)lemmysubreddit[](array)discordchannelslackchanneltelegram__typepinterestboarddribbbletitle__typemediumtitle,subtitledevtotitlehashnodetitle,tags[]wordpresstitle,type__typegmbtopicType,callToActionType)listmonksubject,preview,list