> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload-Post

> Upload-Post publishes, schedules, and manages content across social networks through one API.

![Upload-Post logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/upload_post.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=f52bc41ddffc415955a32d791c24401c)

* **Category:** social media marketing
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `UPLOAD_POST`
* **Version:** 20261101\_00

## Tools

> [accordion] Cancel Scheduled Post
>
> **Slug:** `UPLOAD_POST_CANCEL_SCHEDULED_POST`
>
> Permanently cancel a scheduled post before publication and delete its staged assets.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> Job ID returned by SCHEDULE\_POST, ENQUEUE\_POST, or LIST\_SCHEDULED\_POSTS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Profile
>
> **Slug:** `UPLOAD_POST_CREATE_PROFILE`
>
> Create an Upload-Post profile for a unique caller-owned username; this does not connect any social platform.
>
> #### Input Parameters
>
> **username** `string` *required*
>
> Unique stable profile identifier from the caller's system; reuse it as profile\_username when publishing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enqueue Post
>
> **Slug:** `UPLOAD_POST_ENQUEUE_POST`
>
> Insert one video, photo carousel, or text post into a profile's external publication queue.
>
> #### Input Parameters
>
> **title** `string`
>
> Post title or primary text. Required for text posts and for media platforms that require a title.
>
> **video** `string`
>
> Video file reference or public URL. Required only for a video post.
>
> **photos** `array`
>
> Media files in carousel order. Instagram and Threads support mixed image/video carousels. Required only for a photo post.
>
> **platforms** `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.
>
> **subreddit** `string`
>
> Target subreddit name without the r/ prefix.
>
> **description** `string`
>
> Optional post caption or extended body text.
>
> **content\_type** `string ("video" | "photos" | "text")` *required*
>
> Post format; selects the video, photo carousel, or text publishing endpoint.
>
> **first\_comment** `string`
>
> First comment for platforms that support one.
>
> **idempotency\_key** `string`
>
> Caller-generated unique key that makes retries return the existing upload instead of creating a duplicate.
>
> **facebook\_page\_id** `string`
>
> Facebook Page destination ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **linkedin\_page\_id** `string`
>
> LinkedIn organization destination ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **profile\_username** `string` *required*
>
> Existing Upload-Post profile username whose connected accounts publish the post.
>
> **max\_posts\_per\_slot** `integer`
>
> Optional queue slot capacity override (1-100).
>
> **pinterest\_board\_id** `string`
>
> Pinterest board ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **google\_business\_location\_id** `string`
>
> Google Business location name or ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Upload Status
>
> **Slug:** `UPLOAD_POST_GET_UPLOAD_STATUS`
>
> Get the processing status and per-platform results for an asynchronous or scheduled upload.
>
> #### Input Parameters
>
> **job\_id** `string`
>
> Job ID returned by SCHEDULE\_POST, ENQUEUE\_POST, or LIST\_SCHEDULED\_POSTS; provide at least one identifier.
>
> **request\_id** `string`
>
> Asynchronous request ID returned by PUBLISH\_POST; provide at least one identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Cached Post Analytics
>
> **Slug:** `UPLOAD_POST_LIST_CACHED_POST_ANALYTICS`
>
> Return one page of cached per-post analytics for a profile without consuming the live platform-analytics request limit.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum analytics snapshots in this page (1-200).
>
> **since** `string`
>
> Inclusive snapshot start date; defaults upstream to the trailing 30-day range.
>
> **until** `string`
>
> Inclusive snapshot end date.
>
> **platform** `string ("instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "pinterest" | "reddit" | "x" | "bluesky")`
>
> Optional connected platform slug to filter analytics snapshots.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> **profile\_username** `string` *required*
>
> Upload-Post profile username. An empty result does not prove the profile exists; verify it with LIST\_PROFILES when needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Platform Destinations
>
> **Slug:** `UPLOAD_POST_LIST_PLATFORM_DESTINATIONS`
>
> List selectable Facebook Pages, LinkedIn organizations, Pinterest boards, or Google Business locations for an already connected profile.
>
> #### Input Parameters
>
> **platform** `string ("facebook" | "linkedin" | "pinterest" | "google_business")` *required*
>
> Connected platform whose publish destinations to list.
>
> **profile\_username** `string`
>
> Profile to inspect when the account has multiple profiles; omit only when Upload-Post can resolve the account unambiguously.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Profiles
>
> **Slug:** `UPLOAD_POST_LIST_PROFILES`
>
> List 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Scheduled Posts
>
> **Slug:** `UPLOAD_POST_LIST_SCHEDULED_POSTS`
>
> Return one page of pending scheduled posts and the job IDs needed to edit or cancel them.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of scheduled posts to return in this page.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Upload History
>
> **Slug:** `UPLOAD_POST_LIST_UPLOAD_HISTORY`
>
> Return one page of past and in-progress Upload-Post uploads, including platform post IDs, URLs, request IDs, and failures.
>
> #### Input Parameters
>
> **limit** `integer ("10" | "20" | "50" | "100")`
>
> Maximum history records in this page. Upload-Post accepts only 10, 20, 50, or 100.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor from a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Publish Post
>
> **Slug:** `UPLOAD_POST_PUBLISH_POST`
>
> Submit 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
>
> **title** `string`
>
> Post title or primary text. Required for text posts and for media platforms that require a title.
>
> **video** `string`
>
> Video file reference or public URL. Required only for a video post.
>
> **photos** `array`
>
> Media files in carousel order. Instagram and Threads support mixed image/video carousels. Required only for a photo post.
>
> **platforms** `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.
>
> **subreddit** `string`
>
> Target subreddit name without the r/ prefix.
>
> **description** `string`
>
> Optional post caption or extended body text.
>
> **async\_upload** `boolean`
>
> Return a request ID immediately and publish in the background. A long synchronous upload may also fall back to async.
>
> **content\_type** `string ("video" | "photos" | "text")` *required*
>
> Post format; selects the video, photo carousel, or text publishing endpoint.
>
> **first\_comment** `string`
>
> First comment for platforms that support one.
>
> **idempotency\_key** `string`
>
> Caller-generated unique key that makes retries return the existing upload instead of creating a duplicate.
>
> **facebook\_page\_id** `string`
>
> Facebook Page destination ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **linkedin\_page\_id** `string`
>
> LinkedIn organization destination ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **profile\_username** `string` *required*
>
> Existing Upload-Post profile username whose connected accounts publish the post.
>
> **pinterest\_board\_id** `string`
>
> Pinterest board ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **google\_business\_location\_id** `string`
>
> Google Business location name or ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Schedule Post
>
> **Slug:** `UPLOAD_POST_SCHEDULE_POST`
>
> Schedule one video, photo carousel, or text post for future external publication to connected platforms.
>
> #### Input Parameters
>
> **title** `string`
>
> Post title or primary text. Required for text posts and for media platforms that require a title.
>
> **video** `string`
>
> Video file reference or public URL. Required only for a video post.
>
> **photos** `array`
>
> Media files in carousel order. Instagram and Threads support mixed image/video carousels. Required only for a photo post.
>
> **timezone** `string`
>
> IANA timezone used to interpret a timezone-naive scheduled\_date, for example America/New\_York.
>
> **platforms** `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.
>
> **subreddit** `string`
>
> Target subreddit name without the r/ prefix.
>
> **description** `string`
>
> Optional post caption or extended body text.
>
> **content\_type** `string ("video" | "photos" | "text")` *required*
>
> Post format; selects the video, photo carousel, or text publishing endpoint.
>
> **first\_comment** `string`
>
> First comment for platforms that support one.
>
> **scheduled\_date** `string` *required*
>
> Future publication time no more than 365 days ahead.
>
> **idempotency\_key** `string`
>
> Caller-generated unique key that makes retries return the existing upload instead of creating a duplicate.
>
> **facebook\_page\_id** `string`
>
> Facebook Page destination ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **linkedin\_page\_id** `string`
>
> LinkedIn organization destination ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **profile\_username** `string` *required*
>
> Existing Upload-Post profile username whose connected accounts publish the post.
>
> **pinterest\_board\_id** `string`
>
> Pinterest board ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> **google\_business\_location\_id** `string`
>
> Google Business location name or ID returned by LIST\_PLATFORM\_DESTINATIONS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Scheduled Post
>
> **Slug:** `UPLOAD_POST_UPDATE_SCHEDULED_POST`
>
> Change the future publication time, title, or caption of an existing scheduled post.
>
> #### Input Parameters
>
> **title** `string`
>
> Replacement post title.
>
> **job\_id** `string` *required*
>
> Job ID returned by SCHEDULE\_POST, ENQUEUE\_POST, or LIST\_SCHEDULED\_POSTS.
>
> **caption** `string`
>
> Replacement post caption.
>
> **timezone** `string`
>
> IANA timezone used to interpret a timezone-naive scheduled\_date; absent defaults to UTC.
>
> **scheduled\_date** `string`
>
> Replacement publication time. Must be in the future and no more than 365 days ahead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
