Post a video to social platforms
post_videoPublish a video to multiple social media platforms including TikTok, Instagram, YouTube, LinkedIn, and more. Supports scheduling, first comments, and platform-specific settings.
Instructions
Publish a video to tiktok, instagram (reels/stories), youtube, linkedin, facebook, x, threads, pinterest, bluesky, discord, telegram. The video can be a local file path or a public http(s) URL. 'title' is required for YouTube and Reddit. YouTube extras (tags, categoryId, privacyStatus...), Instagram media_type, TikTok privacy etc. go in extra_params.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | Yes | Upload-post profile identifier whose connected social accounts will be used. | |
| title | No | Default post text / title / caption. Required for YouTube and Reddit; for text posts this IS the post content. | |
| video | Yes | Video: local file path or public URL. | |
| timezone | No | IANA timezone for scheduled_date (e.g. 'America/New_York'). Defaults to UTC. | |
| platforms | Yes | Target platform(s). | |
| subreddit | No | Subreddit name without 'r/' — required when platforms includes reddit. | |
| thumbnail | No | YouTube custom thumbnail: local file path or public URL (max 2MB). | |
| description | No | Extended text (LinkedIn commentary, Facebook/YouTube/Pinterest/TikTok descriptions, Reddit body). | |
| add_to_queue | No | Schedule into the next available queue slot instead. Cannot combine with scheduled_date. | |
| async_upload | No | Return immediately with a request_id and process in background (poll with get_upload_status). | |
| extra_params | No | Any additional platform-specific form fields from the upload-post API docs, passed through verbatim. Examples: {linkedin_title: '...'}, {privacy_level: 'PUBLIC_TO_EVERYONE'}, {media_type: 'REELS'}, {poll_options: ['a','b'], poll_duration: 1440}, {'tags[]': ['tag1','tag2']}. | |
| first_comment | No | Automatically post this as the first comment after publishing. | |
| scheduled_date | No | ISO-8601 date/time to schedule publishing (must be in the future, ≤365 days). Omit to publish now. | |
| youtube_privacy | No | YouTube privacyStatus. | |
| facebook_page_id | No | Facebook Page ID — required when platforms includes facebook (auto-detected if only one page). Use list_page_targets to find it. | |
| pinterest_board_id | No | Pinterest board ID — required when platforms includes pinterest. Use list_page_targets to find it. | |
| target_linkedin_page_id | No | LinkedIn organization page ID to post as a company page instead of the personal profile. |