Post a video

Permissions used: posts:write, plus posts:schedule to schedule.

Get the file in

From a link

For a public https link straight to the file (not a web page):

Import https://example.com/demo.mp4 and draft it as an Instagram Reel and a LinkedIn video post.

import_media_from_url copies it in (images up to 20 MB, video up to 300 MB) and returns an asset.

From your computer

Agents that can run commands, such as Claude Code, upload in three steps:

1. create_media_upload returns a presigned uploadUrl and the headers to send.
2. PUT the file to it within 15 minutes:

   curl -X PUT -H 'content-type: video/mp4' --upload-file clip.mp4 '<uploadUrl>'

3. complete_media_upload returns the asset.

Draft and publish

Pass the asset as media to create_draft_post. After approval:

• X, LinkedIn (MP4 only), Instagram, TikTok and YouTube finish processing on the platform within a few minutes, so the post shows awaiting_platform until it’s live.
• Instagram posts videos as Reels. Facebook Pages post vertical videos of 3 to 90 seconds as Reels.
• YouTube uploads use the copy as the description and youtube.title as the title; vertical or square videos up to 3 minutes post as Shorts.
• TikTok drafts land in your TikTok inbox to finish in the TikTok app.

Uploaded files count toward your workspace storage, and the largest video you can upload depends on your plan. get_usage shows both.