Create Post

Post type: now, schedule, or draft

The top-level type field controls when (and whether) the post is published:

Drafts are how you stage content via the API without committing to a publish time, useful for content review workflows or pre-filling a calendar from an external CMS.

Duplicating a post

There is no dedicated duplicate / clone endpoint. To copy an existing post, fetch it with GET /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:

• id and any nested post IDs
• createdAt, updatedAt, and any other timestamps
• state / status / releaseId (these are assigned by the scheduler)
• Anything else the API didn’t ask you to provide when you originally created the post

Then set a fresh 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. The settings 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:

{
  "settings": {
    "__type": "threads"
  }
}

Platforms: threads, mastodon, bluesky, telegram, nostr, vk

Detailed Provider Settings

See the Provider Settings section for detailed schemas and examples for each platform.