---
canonical_url: "https://docs.composio.dev/toolkits/postpone"
markdown_url: "https://docs.composio.dev/toolkits/postpone.md"
product: "platform"
version: null
last_updated: null
---

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

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

## Tools

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post` | string | Yes | 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") | Yes | Destination platform. Must match post.platform and selects a fixed mutation. |
| `scheduling_mode` | string ("SPECIFIC_TIME" | "QUEUE_NEXT") | Yes | SPECIFIC_TIME uses post dates; QUEUE_NEXT rejects all post dates and uses the next account-schedule slot. |
| `publishing_status` | string ("DRAFT" | "IN_REVIEW") | Yes | Internal Postpone state: DRAFT for later editing or IN_REVIEW for approval. Neither state publishes externally. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | 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") | Yes | Social platform associated with the Postpone post ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `platform` | string ("youtube" | "twitter" | "tumblr" | "tiktok" | "threads" | "reddit" | "pinterest" | "mastodon" | "linkedin" | "instagram" | "facebook" | "bluesky") | No | Optional platform name used only to filter connected social accounts, such as twitter or instagram. |
| `include_archived_tags` | boolean | No | Include archived post tags as well as active tags. |
| `schedule_social_account_ids` | array | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum posts to return on this page. Default is 25. |
| `cursor` | string | No | Positive page cursor returned by a previous call. Use it with the same platform and filters; omit it for the first page. |
| `search` | string | No | Text to search for in the platform's post content. |
| `sort_by` | string ("DATE" | "LIKES" | "COMMENTS") | No | Field used to sort matches: DATE, LIKES, or COMMENTS. |
| `end_date` | string | No | 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") | Yes | Social platform whose posts to list. |
| `media_ids` | array | No | Media IDs attached to matching posts. |
| `roots_only` | boolean | No | Return only root posts for TWITTER, THREADS, MASTODON, or BLUESKY. Omit for other platforms. |
| `start_date` | string | No | Inclusive start of the post date range in ISO 8601 format. |
| `post_tag_ids` | array | No | Postpone post tag IDs that matching posts must have. |
| `submission_type` | string ("ALL" | "SCHEDULED" | "SUBMITTED" | "FAILED" | "ATTEMPTED") | No | Lifecycle group to return: ALL, SCHEDULED, SUBMITTED, FAILED, or ATTEMPTED. |
| `publishing_status` | string ("DRAFT" | "READY_TO_PUBLISH" | "IN_REVIEW") | No | Optional Postpone publishing status: DRAFT, READY_TO_PUBLISH, or IN_REVIEW. |
| `social_account_ids` | array | No | Connected social account IDs to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Schedule Post

**Slug:** `POSTPONE_SCHEDULE_POST`

Schedule a platform-specific Postpone post for external publication at a specific time or the next queue slot. Configured repost and removal rules run automatically, and media supplied by URL is saved to the Content Library.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post` | string | Yes | 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") | Yes | Destination platform. Must match post.platform and selects a fixed mutation. |
| `scheduling_mode` | string ("SPECIFIC_TIME" | "QUEUE_NEXT") | Yes | SPECIFIC_TIME requires post dates; QUEUE_NEXT rejects all post dates and uses the next account-schedule slot. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum media items to return on this page (1-100). |
| `cursor` | string | No | Continuation page number returned by a previous call; omit for the first page. |
| `search` | string | No | 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") | No | Sort by id, mime_type, size, name, or date_created; prefix the value with - for descending order. |
| `file_type` | string ("ALL" | "VIDEO" | "IMAGE" | "GIF") | No | Media type to return: ALL, VIDEO, IMAGE, or GIF. |
| `label_ids` | array | No | Return only media assigned to any of these Content Library label IDs. |
| `media_ids` | array | No | Return only media with these Postpone media IDs. |
| `external_ids` | array | No | Return only media with these external provider IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post` | string | Yes | 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") | Yes | Platform of the existing Postpone post; selects the documented update mutation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |