Skip to main content
Upload-Post logo
  • Category: social media marketing
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 12
  • Triggers: 0
  • Slug: UPLOAD_POST
  • Version: 20261101_00

Tools

Slug: UPLOAD_POST_CANCEL_SCHEDULED_POSTPermanently cancel a scheduled post before publication and delete its staged assets.

Input Parameters

string
required
Job ID returned by SCHEDULE_POST, ENQUEUE_POST, or LIST_SCHEDULED_POSTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_CREATE_PROFILECreate an Upload-Post profile for a unique caller-owned username; this does not connect any social platform.

Input Parameters

string
required
Unique stable profile identifier from the caller’s system; reuse it as profile_username when publishing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_ENQUEUE_POSTInsert one video, photo carousel, or text post into a profile’s external publication queue.

Input Parameters

string
Post title or primary text. Required for text posts and for media platforms that require a title.
string
Video file reference or public URL. Required only for a video post.
array
Media files in carousel order. Instagram and Threads support mixed image/video carousels. Required only for a photo post.
array
required
Connected platform slugs compatible with content_type. Video supports tiktok, instagram, linkedin, youtube, facebook, x, threads, pinterest, bluesky, reddit, google_business, discord, and telegram. Photos support the same set except youtube. Text supports linkedin, x, facebook, threads, reddit, bluesky, google_business, discord, and telegram. TikTok publishing requires a paid plan.
string
Target subreddit name without the r/ prefix.
string
Optional post caption or extended body text.
string ("video" | "photos" | "text")
required
Post format; selects the video, photo carousel, or text publishing endpoint.
string
First comment for platforms that support one.
string
Caller-generated unique key that makes retries return the existing upload instead of creating a duplicate.
string
Facebook Page destination ID returned by LIST_PLATFORM_DESTINATIONS.
string
LinkedIn organization destination ID returned by LIST_PLATFORM_DESTINATIONS.
string
required
Existing Upload-Post profile username whose connected accounts publish the post.
integer
Optional queue slot capacity override (1-100).
string
Pinterest board ID returned by LIST_PLATFORM_DESTINATIONS.
string
Google Business location name or ID returned by LIST_PLATFORM_DESTINATIONS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_GET_UPLOAD_STATUSGet the processing status and per-platform results for an asynchronous or scheduled upload.

Input Parameters

string
Job ID returned by SCHEDULE_POST, ENQUEUE_POST, or LIST_SCHEDULED_POSTS; provide at least one identifier.
string
Asynchronous request ID returned by PUBLISH_POST; provide at least one identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_LIST_CACHED_POST_ANALYTICSReturn one page of cached per-post analytics for a profile without consuming the live platform-analytics request limit.

Input Parameters

integer
Maximum analytics snapshots in this page (1-200).
string
Inclusive snapshot start date; defaults upstream to the trailing 30-day range.
string
Inclusive snapshot end date.
string ("instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "pinterest" | "reddit" | "x" | "bluesky")
Optional connected platform slug to filter analytics snapshots.
string
Opaque continuation cursor returned by a previous call; omit for the first page.
string
required
Upload-Post profile username. An empty result does not prove the profile exists; verify it with LIST_PROFILES when needed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_LIST_PLATFORM_DESTINATIONSList selectable Facebook Pages, LinkedIn organizations, Pinterest boards, or Google Business locations for an already connected profile.

Input Parameters

string ("facebook" | "linkedin" | "pinterest" | "google_business")
required
Connected platform whose publish destinations to list.
string
Profile to inspect when the account has multiple profiles; omit only when Upload-Post can resolve the account unambiguously.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_LIST_PROFILESList Upload-Post profiles and their connected social accounts. Use this before publishing to verify the profile exists and inspect platform connection or reauthentication prerequisites.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_LIST_SCHEDULED_POSTSReturn one page of pending scheduled posts and the job IDs needed to edit or cancel them.

Input Parameters

integer
Maximum number of scheduled posts to return in this page.
string
Opaque continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_LIST_UPLOAD_HISTORYReturn one page of past and in-progress Upload-Post uploads, including platform post IDs, URLs, request IDs, and failures.

Input Parameters

integer ("10" | "20" | "50" | "100")
Maximum history records in this page. Upload-Post accepts only 10, 20, 50, or 100.
string
Opaque continuation cursor from a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_PUBLISH_POSTSubmit one video, photo carousel, or text post for publication to connected platforms. Publishing may run asynchronously, and successful request acceptance can still include individual platform failures.

Input Parameters

string
Post title or primary text. Required for text posts and for media platforms that require a title.
string
Video file reference or public URL. Required only for a video post.
array
Media files in carousel order. Instagram and Threads support mixed image/video carousels. Required only for a photo post.
array
required
Connected platform slugs compatible with content_type. Video supports tiktok, instagram, linkedin, youtube, facebook, x, threads, pinterest, bluesky, reddit, google_business, discord, and telegram. Photos support the same set except youtube. Text supports linkedin, x, facebook, threads, reddit, bluesky, google_business, discord, and telegram. TikTok publishing requires a paid plan.
string
Target subreddit name without the r/ prefix.
string
Optional post caption or extended body text.
boolean
Return a request ID immediately and publish in the background. A long synchronous upload may also fall back to async.
string ("video" | "photos" | "text")
required
Post format; selects the video, photo carousel, or text publishing endpoint.
string
First comment for platforms that support one.
string
Caller-generated unique key that makes retries return the existing upload instead of creating a duplicate.
string
Facebook Page destination ID returned by LIST_PLATFORM_DESTINATIONS.
string
LinkedIn organization destination ID returned by LIST_PLATFORM_DESTINATIONS.
string
required
Existing Upload-Post profile username whose connected accounts publish the post.
string
Pinterest board ID returned by LIST_PLATFORM_DESTINATIONS.
string
Google Business location name or ID returned by LIST_PLATFORM_DESTINATIONS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_SCHEDULE_POSTSchedule one video, photo carousel, or text post for future external publication to connected platforms.

Input Parameters

string
Post title or primary text. Required for text posts and for media platforms that require a title.
string
Video file reference or public URL. Required only for a video post.
array
Media files in carousel order. Instagram and Threads support mixed image/video carousels. Required only for a photo post.
string
IANA timezone used to interpret a timezone-naive scheduled_date, for example America/New_York.
array
required
Connected platform slugs compatible with content_type. Video supports tiktok, instagram, linkedin, youtube, facebook, x, threads, pinterest, bluesky, reddit, google_business, discord, and telegram. Photos support the same set except youtube. Text supports linkedin, x, facebook, threads, reddit, bluesky, google_business, discord, and telegram. TikTok publishing requires a paid plan.
string
Target subreddit name without the r/ prefix.
string
Optional post caption or extended body text.
string ("video" | "photos" | "text")
required
Post format; selects the video, photo carousel, or text publishing endpoint.
string
First comment for platforms that support one.
string
required
Future publication time no more than 365 days ahead.
string
Caller-generated unique key that makes retries return the existing upload instead of creating a duplicate.
string
Facebook Page destination ID returned by LIST_PLATFORM_DESTINATIONS.
string
LinkedIn organization destination ID returned by LIST_PLATFORM_DESTINATIONS.
string
required
Existing Upload-Post profile username whose connected accounts publish the post.
string
Pinterest board ID returned by LIST_PLATFORM_DESTINATIONS.
string
Google Business location name or ID returned by LIST_PLATFORM_DESTINATIONS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: UPLOAD_POST_UPDATE_SCHEDULED_POSTChange the future publication time, title, or caption of an existing scheduled post.

Input Parameters

string
Replacement post title.
string
required
Job ID returned by SCHEDULE_POST, ENQUEUE_POST, or LIST_SCHEDULED_POSTS.
string
Replacement post caption.
string
IANA timezone used to interpret a timezone-naive scheduled_date; absent defaults to UTC.
string
Replacement publication time. Must be in the future and no more than 365 days ahead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not