Posts

Create a post

Manually create a post with your own content. Supports text, image, and carousel post types. Media URLs must be publicly accessible.

For video / Reels (TikTok, YouTube, Instagram Reels, Facebook Reels, X, Threads, LinkedIn), use POST /v1/videos instead — postType="video" is not accepted here.

Attaching a raw file you have inline (e.g. a file the user uploaded to Claude/ChatGPT): first call uploadImage with the base64 data to get a public imageUrl, then pass that here. Posting an existing image already on the web works too — call uploadImage with sourceUrl first so the URL ends up on a TikTok-whitelisted domain.

post/v1/posts/create

Request

  • Base URL: https://www.postquick.ai/api
  • URL: https://www.postquick.ai/api/v1/posts/create
  • Auth: HTTP bearer

Request body

contentGroupIdstring required

Content group (app) that owns this post

contentstring required

Post body text / caption

postType'text' | 'image' | 'carousel' required
platformsstring[]
imageUrlstring uri

Required for postType=image

imageUrlsstring[]

Required for postType=carousel. Per-platform image limits apply: X/Twitter 4, Threads 20.

isDraftboolean

Save as draft instead of pending. Default false.

scheduledForstring date-time

ISO 8601 timestamp for scheduling

Response

Post created.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.