> ## 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.

# Postpone

> Postpone is a social media management platform for scheduling, publishing, and analyzing content across Reddit, X, Instagram, Facebook, TikTok, YouTube, LinkedIn, Pinterest, Mastodon, Bluesky, Threads, and Tumblr.

![Postpone logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/postpone.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=cee01c13838055ade68e68f66ef8d71a)

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

## Tools

> [accordion] Create Post
>
> **Slug:** `POSTPONE_CREATE_POST`
>
> Create a platform-specific Postpone draft or review item without publishing externally. Media supplied by URL is saved to the Content Library.
>
> #### Input Parameters
>
> **post** `string` *required*
>
> Exact platform-specific post input. Its platform discriminator must match the top-level platform.
>
> **platform** `string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")` *required*
>
> Destination platform. Must match post.platform and selects a fixed mutation.
>
> **scheduling\_mode** `string ("SPECIFIC_TIME" | "QUEUE_NEXT")` *required*
>
> SPECIFIC\_TIME uses post dates; QUEUE\_NEXT rejects all post dates and uses the next account-schedule slot.
>
> **publishing\_status** `string ("DRAFT" | "IN_REVIEW")` *required*
>
> Internal Postpone state: DRAFT for later editing or IN\_REVIEW for approval. Neither state publishes externally.
>
> #### 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 Post
>
> **Slug:** `POSTPONE_GET_POST`
>
> Retrieve one Postpone post by its Postpone ID and social platform, including its content, schedule, submissions, media, tags, and publishing state.
>
> #### Input Parameters
>
> **post\_id** `string` *required*
>
> Postpone post ID returned by LIST\_POSTS or a scheduling tool. This is not the external social-platform post ID. Reddit post IDs must be numeric.
>
> **platform** `string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")` *required*
>
> Social platform associated with the Postpone post ID.
>
> #### 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 Publishing Context
>
> **Slug:** `POSTPONE_GET_PUBLISHING_CONTEXT`
>
> Return the connected Postpone profile and plan limits, social accounts, post tags, and next open schedule dates needed to prepare a post.
>
> #### Input Parameters
>
> **platform** `string ("youtube" | "twitter" | "tumblr" | "tiktok" | "threads" | "reddit" | "pinterest" | "mastodon" | "linkedin" | "instagram" | "facebook" | "bluesky")`
>
> Optional platform name used only to filter connected social accounts, such as twitter or instagram.
>
> **include\_archived\_tags** `boolean`
>
> Include archived post tags as well as active tags.
>
> **schedule\_social\_account\_ids** `array`
>
> Optional social account IDs whose next open Account Schedule dates to return. Reddit account IDs are unsupported and make Postpone reject the query; omit this field to return dates for all supported accounts.
>
> #### 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 Posts
>
> **Slug:** `POSTPONE_LIST_POSTS`
>
> List one page of scheduled, submitted, failed, attempted, or draft post submissions for one social platform. Supports account, date, status, tag, media, and text filters; pass next\_cursor back as cursor to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum posts to return on this page. Default is 25.
>
> **cursor** `string`
>
> Positive page cursor returned by a previous call. Use it with the same platform and filters; omit it for the first page.
>
> **search** `string`
>
> Text to search for in the platform's post content.
>
> **sort\_by** `string ("DATE" | "LIKES" | "COMMENTS")`
>
> Field used to sort matches: DATE, LIKES, or COMMENTS.
>
> **end\_date** `string`
>
> Inclusive end of the post date range in ISO 8601 format.
>
> **platform** `string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")` *required*
>
> Social platform whose posts to list.
>
> **media\_ids** `array`
>
> Media IDs attached to matching posts.
>
> **roots\_only** `boolean`
>
> Return only root posts for TWITTER, THREADS, MASTODON, or BLUESKY. Omit for other platforms.
>
> **start\_date** `string`
>
> Inclusive start of the post date range in ISO 8601 format.
>
> **post\_tag\_ids** `array`
>
> Postpone post tag IDs that matching posts must have.
>
> **submission\_type** `string ("ALL" | "SCHEDULED" | "SUBMITTED" | "FAILED" | "ATTEMPTED")`
>
> Lifecycle group to return: ALL, SCHEDULED, SUBMITTED, FAILED, or ATTEMPTED.
>
> **publishing\_status** `string ("DRAFT" | "READY_TO_PUBLISH" | "IN_REVIEW")`
>
> Optional Postpone publishing status: DRAFT, READY\_TO\_PUBLISH, or IN\_REVIEW.
>
> **social\_account\_ids** `array`
>
> Connected social account IDs to include.
>
> #### 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:** `POSTPONE_SCHEDULE_POST`
>
> Schedule a platform-specific Postpone post at a specific time or the next queue slot, with optional repost and removal rules; media supplied by URL is saved to the Content Library. Reddit scheduling uses notification posting and requires completing the submission in Reddit.
>
> #### Input Parameters
>
> **post** `string` *required*
>
> Exact platform-specific post input. Its platform discriminator must match the top-level platform.
>
> **platform** `string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")` *required*
>
> Destination platform. Must match post.platform and selects a fixed mutation.
>
> **scheduling\_mode** `string ("SPECIFIC_TIME" | "QUEUE_NEXT")` *required*
>
> SPECIFIC\_TIME requires post dates; QUEUE\_NEXT rejects all post dates and uses the next account-schedule slot.
>
> #### 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] Search Media
>
> **Slug:** `POSTPONE_SEARCH_MEDIA`
>
> Search and filter one page of Content Library media for assets that can be attached to posts.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum media items to return on this page (1-100).
>
> **cursor** `string`
>
> Continuation page number returned by a previous call; omit for the first page.
>
> **search** `string`
>
> Case-insensitive text to match against media names.
>
> **order\_by** `string ("id" | "-id" | "mime_type" | "-mime_type" | "size" | "-size" | "name" | "-name" | "date_created" | "-date_created")`
>
> Sort by id, mime\_type, size, name, or date\_created; prefix the value with - for descending order.
>
> **file\_type** `string ("ALL" | "VIDEO" | "IMAGE" | "GIF")`
>
> Media type to return: ALL, VIDEO, IMAGE, or GIF.
>
> **label\_ids** `array`
>
> Return only media assigned to any of these Content Library label IDs.
>
> **media\_ids** `array`
>
> Return only media with these Postpone media IDs.
>
> **external\_ids** `array`
>
> Return only media with these external provider IDs.
>
> #### 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 Post
>
> **Slug:** `POSTPONE_UPDATE_POST`
>
> Replace the full editable state, including publishing state and automatic repost or removal rules, of a scheduled, draft, or review Postpone post. READY\_TO\_PUBLISH may publish externally at the scheduled time; this does not edit an already-published external post.
>
> #### Input Parameters
>
> **post** `string` *required*
>
> Complete platform-specific replacement state, including the required Postpone post ID. Start from GET\_POST and include values that must remain unchanged.
>
> **platform** `string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")` *required*
>
> Platform of the existing Postpone post; selects the documented update mutation.
>
> #### 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
