Actions29
- Account Actions
- Pool Actions
- Short Link Actions
- Upload Actions
- Webhook Actions
Upload → Create
AI-generatedSummary
Uploads media files (images or videos) to a specified connected account on platforms like YouTube, TikTok, Instagram, and others, with options for scheduling, metadata, and platform-specific settings.
Inputs
- accountId (required) — ID of the connected account to post to.
- media — Binary property names and/or URLs. Single file: 'data'. Carousel: 'data0,data1,data2'. For URLs containing commas (e.g. Cloudinary), use a JSON array: ["https://url1","https://url2"]. Defaults to 'data'.
- mediaType — Media type classification: Auto Detect (default), Video, or Image. Determines whether the field is named 'video' or 'photo' when sending to the API.
- additionalFields — A collection of platform-specific and general metadata parameters, including caption, title, tags, scheduled date, timezone, and platform-specific settings (e.g., YouTube privacy, TikTok brand content flags, Instagram media type).
Output shape
One item per input item, containing the response data from the upload job (e.g., job ID, status, or final post data).
By default, returns a job ID immediately. If 'Wait For Completion' is set to true, waits up to 10 minutes for the upload job to finish before returning the final result.
Examples
Example 1: Upload a single video to YouTube
Select 'YouTube' as the account, upload a binary video file named 'data', set Media Type to 'Video', and configure YouTube-specific fields like privacy status and embeddability.
Example 2: Schedule an Instagram carousel post
Set Media to 'data0,data1' (multiple images), leave Media Type as 'Auto Detect', add captions in the Description field, set Scheduled Date and Timezone, and optionally disable comments for TikTok.
Example 3: Upload from a remote URL
Provide the direct URL of the media in the Media field (e.g., 'https://cdn.example.com/video.mp4') instead of a binary property name.