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

Tools

Slug: POSTPONE_CREATE_POSTCreate a platform-specific Postpone draft or review item without publishing externally. Media supplied by URL is saved to the Content Library.

Input Parameters

string
required
Exact platform-specific post input. Its platform discriminator must match the top-level 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.
string ("SPECIFIC_TIME" | "QUEUE_NEXT")
required
SPECIFIC_TIME uses post dates; QUEUE_NEXT rejects all post dates and uses the next account-schedule slot.
string ("DRAFT" | "IN_REVIEW")
required
Internal Postpone state: DRAFT for later editing or IN_REVIEW for approval. Neither state publishes externally.

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: POSTPONE_GET_POSTRetrieve one Postpone post by its Postpone ID and social platform, including its content, schedule, submissions, media, tags, and publishing state.

Input Parameters

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.
string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")
required
Social platform associated with the Postpone post ID.

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: POSTPONE_GET_PUBLISHING_CONTEXTReturn the connected Postpone profile and plan limits, social accounts, post tags, and next open schedule dates needed to prepare a post.

Input Parameters

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.
boolean
Include archived post tags as well as active tags.
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

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: POSTPONE_LIST_POSTSList 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

integer
Maximum posts to return on this page. Default is 25.
string
Positive page cursor returned by a previous call. Use it with the same platform and filters; omit it for the first page.
Text to search for in the platform’s post content.
string ("DATE" | "LIKES" | "COMMENTS")
Field used to sort matches: DATE, LIKES, or COMMENTS.
string
Inclusive end of the post date range in ISO 8601 format.
string ("YOUTUBE" | "TWITTER" | "TUMBLR" | "TIKTOK" | "THREADS" | "REDDIT" | "PINTEREST" | "MASTODON" | "LINKEDIN" | "INSTAGRAM" | "FACEBOOK" | "BLUESKY")
required
Social platform whose posts to list.
array
Media IDs attached to matching posts.
boolean
Return only root posts for TWITTER, THREADS, MASTODON, or BLUESKY. Omit for other platforms.
string
Inclusive start of the post date range in ISO 8601 format.
array
Postpone post tag IDs that matching posts must have.
string ("ALL" | "SCHEDULED" | "SUBMITTED" | "FAILED" | "ATTEMPTED")
Lifecycle group to return: ALL, SCHEDULED, SUBMITTED, FAILED, or ATTEMPTED.
string ("DRAFT" | "READY_TO_PUBLISH" | "IN_REVIEW")
Optional Postpone publishing status: DRAFT, READY_TO_PUBLISH, or IN_REVIEW.
array
Connected social account IDs to include.

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: POSTPONE_SCHEDULE_POSTSchedule 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

string
required
Exact platform-specific post input. Its platform discriminator must match the top-level 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.
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

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: POSTPONE_SEARCH_MEDIASearch and filter one page of Content Library media for assets that can be attached to posts.

Input Parameters

integer
Maximum media items to return on this page (1-100).
string
Continuation page number returned by a previous call; omit for the first page.
string
Case-insensitive text to match against media names.
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.
string ("ALL" | "VIDEO" | "IMAGE" | "GIF")
Media type to return: ALL, VIDEO, IMAGE, or GIF.
array
Return only media assigned to any of these Content Library label IDs.
array
Return only media with these Postpone media IDs.
array
Return only media with these external provider IDs.

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: POSTPONE_UPDATE_POSTReplace 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

string
required
Complete platform-specific replacement state, including the required Postpone post ID. Start from GET_POST and include values that must remain unchanged.
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

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