Videos

Create a video (Reel) from a URL

Create a video post (Reel) draft from an existing publicly accessible video URL. Pass videoUrl (or legacy media_url) directly to skip /v1/videos/upload: PostQuick stores the URL as-is and does not copy the media into Supabase. Then call POST /v1/videos/{videoId}/schedule or /publish. Use /v1/videos/upload only when your host is not publicly reachable or a platform requires a PostQuick-hosted URL.

post/v1/videos

Request

Base URL: https://www.postquick.ai/api
URL: https://www.postquick.ai/api/v1/videos
Auth: HTTP bearer

Request body

contentGroupIdstring required

Content group (app) that owns this video.

videoUrlstring uri

Publicly accessible HTTP(S) video URL. Use this directly to skip /v1/videos/upload; PostQuick stores the URL without copying the media.

mediaUrlstring uri

Backward-compatible alias for videoUrl.

media_urlstring uri

Legacy snake_case alias for videoUrl.

titlestring

Title (used by YouTube; optional elsewhere).

descriptionstring

Caption / description.

thumbnailUrlstring uri

Optional thumbnail image URL.

durationinteger

Duration in seconds.

resolutionstring

e.g. "1080x1920".

platformsstring[]

Target platforms. Can also be set later via publish/schedule.

visibilitystring

Platform visibility, e.g. "public". Default "public".

tagsstring[]

categorystring

tiktokSettingsobject

Response

Video draft created.

successtrue required

Changes

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