AdaptlyPost

Bulk Schedule Posts

bulk_schedule_posts

Destructive

Schedule up to 100 posts in one call to the same platforms and accounts. Each item supplies its own text, contentType, scheduledAt, and optional media; platforms, connection-id arrays, timezone, and platform configs are shared by every item, though an item may carry its own tiktokConfigs, youtubeConfigs, instagramConfigs, facebookConfigs or pinterestConfigs to replace the shared ones. Items are processed independently: each is validated and created like create_post, so one bad item fails alone while the rest are scheduled. Returns { totalScheduled, totalFailed, results[] } with a postId or errorMessage per item, in input order; read every row. An item with a past scheduledAt publishes immediately rather than being rejected. Call list_accounts first; TikTok needs tiktokConfigs with privacyLevel and Pinterest needs pinterestConfigs with boardId. Use create_post for a single post or a draft; this tool has no draft mode. These posts publish publicly to the user's social accounts: show the user every item's text, media and time plus the accounts, and get their confirmation before calling. Each call creates new posts, so calling again after an error or timeout can publish duplicates; check list_posts first.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`posts`	Yes	1 to 100 posts to schedule; each is created independently
`pageIds`	No	Facebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array
`timezone`	No	IANA timezone stored with every post for display; does not shift scheduledAt	UTC
`platforms`	Yes	Target platforms shared by every item. Each needs its connection-id array (pageIds for FACEBOOK)
`workspaceId`	No	Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another
`tiktokConfigs`	No	TikTok per-connection config. Each entry needs connectionId + privacyLevel at minimum
`youtubeConfigs`	No	YouTube per-connection config with video title, tags, privacy, etc.
`facebookConfigs`	No	Facebook per-page config with post type and video title. pageId must match an entry in pageIds
`instagramConfigs`	No	Instagram per-connection config to set post type (FEED, REEL, STORY) and publish a reel as a trial reel
`pinterestConfigs`	No	Pinterest per-connection config. Each entry needs connectionId + boardId; there is no API to list boards, so ask the user for the board id
`tiktokConnectionIds`	No	TikTok account connection IDs to post from
`blueskyConnectionIds`	No	Bluesky account connection IDs to post from
`threadsConnectionIds`	No	Threads account connection IDs to post from
`twitterConnectionIds`	No	X (Twitter) account connection IDs to post from
`youtubeConnectionIds`	No	YouTube channel connection IDs to post from
`linkedinConnectionIds`	No	LinkedIn account connection IDs to post from
`mastodonConnectionIds`	No	Mastodon account connection IDs to post from
`instagramConnectionIds`	No	Instagram account connection IDs to post from
`pinterestConnectionIds`	No	Pinterest account connection IDs to post from

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	No	An object with totalScheduled, totalFailed, and results: one { postId, success, isScheduled, scheduledAt, errorMessage } per input item, in input order.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedSep 28, 2026

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

Changed33 schema fields changedSep 27, 2026

addedInput schema / properties / facebookConfigs / items / $ref

Added value: +"#/properties/posts/items/properties/facebookConfigs/items"

removedInput schema / properties / facebookConfigs / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / facebookConfigs / items / properties

Removed value: -{
-  "pageId": {
-    "description": "Facebook page ID from list_accounts",
-    "type": "string"
-  },
-  "postType": {
-    "description": "Facebook post type — FEED, REEL, or STORY",
-    "enum": [
-      "FEED",
-      "REEL",
-      "STORY"
-    ],
-    "type": "string"
-  },
-  "videoTitle": {
-    "description": "Video title for Facebook (max 255 chars)",
-    "maxLength": 255,
-    "type": "string"
-  }
-}

removedInput schema / properties / facebookConfigs / items / required
```
Removed value: -[
-  "pageId"
-]
```
removedInput schema / properties / facebookConfigs / items / type
```
Removed value: -"object"
```

addedInput schema / properties / instagramConfigs / items / $ref

Added value: +"#/properties/posts/items/properties/instagramConfigs/items"

removedInput schema / properties / instagramConfigs / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / instagramConfigs / items / properties

Removed value: -{
-  "connectionId": {
-    "description": "Instagram connection ID from list_accounts",
-    "type": "string"
-  },
-  "postType": {
-    "description": "Instagram post type — FEED, REEL, or STORY",
-    "enum": [
-      "FEED",
-      "REEL",
-      "STORY"
-    ],
-    "type": "string"
-  },
-  "trialGraduation": {
-    "description": "Publish a video reel as a trial reel: Instagram shows it to non-followers first and keeps it off followers' feeds and the profile grid until it is shared. MANUAL means the account owner shares it from the Instagram app; SS_PERFORMANCE means Instagram shares it if it performs well. Only for a single video posted as a reel or feed video, never a story, image or carousel (400 otherwise). Needs a professional account Instagram has enabled for trial reels; otherwise that platform fails with a message saying so",
-    "enum": [
-      "MANUAL",
-      "SS_PERFORMANCE"
-    ],
-    "type": "string"
-  }
-}

removedInput schema / properties / instagramConfigs / items / required
```
Removed value: -[
-  "connectionId"
-]
```
removedInput schema / properties / instagramConfigs / items / type
```
Removed value: -"object"
```

addedInput schema / properties / pinterestConfigs / items / $ref

Added value: +"#/properties/posts/items/properties/pinterestConfigs/items"

removedInput schema / properties / pinterestConfigs / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / pinterestConfigs / items / properties

Removed value: -{
-  "boardId": {
-    "description": "Pinterest board ID to pin to (required)",
-    "type": "string"
-  },
-  "connectionId": {
-    "description": "Pinterest connection ID from list_accounts",
-    "type": "string"
-  },
-  "link": {
-    "description": "Destination URL for the pin",
-    "type": "string"
-  },
-  "title": {
-    "description": "Pin title (max 100 chars)",
-    "maxLength": 100,
-    "type": "string"
-  }
-}

removedInput schema / properties / pinterestConfigs / items / required
```
Removed value: -[
-  "connectionId",
-  "boardId"
-]
```
removedInput schema / properties / pinterestConfigs / items / type
```
Removed value: -"object"
```

addedInput schema / properties / posts / items / properties / facebookConfigs

Added value: +{
+  "description": "Facebook config for this item only; replaces the batch-level facebookConfigs",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "pageId": {
+        "description": "Facebook page ID from list_accounts",
+        "type": "string"
+      },
+      "postType": {
+        "description": "Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE or VIDEO. Any other combination is refused with 400",
+        "enum": [
+          "FEED",
+          "REEL",
+          "STORY"
+        ],
+        "type": "string"
+      },
+      "videoTitle": {
+        "description": "Video title for Facebook (max 255 chars)",
+        "maxLength": 255,
+        "type": "string"
+      }
+    },
+    "required": [
+      "pageId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / posts / items / properties / instagramConfigs

Added value: +{
+  "description": "Instagram config for this item only; replaces the batch-level instagramConfigs",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "connectionId": {
+        "description": "Instagram connection ID from list_accounts",
+        "type": "string"
+      },
+      "postType": {
+        "description": "Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE or VIDEO. Any other combination is refused with 400",
+        "enum": [
+          "FEED",
+          "REEL",
+          "STORY"
+        ],
+        "type": "string"
+      },
+      "trialGraduation": {
+        "description": "Publish a video reel as a trial reel: Instagram shows it to non-followers first and keeps it off followers' feeds and the profile grid until it is shared. MANUAL means the account owner shares it from the Instagram app; SS_PERFORMANCE means Instagram shares it if it performs well. Only for a single video posted as a reel or feed video, never a story, image or carousel (400 otherwise). Needs a professional account Instagram has enabled for trial reels; otherwise that platform fails with a message saying so",
+        "enum": [
+          "MANUAL",
+          "SS_PERFORMANCE"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / posts / items / properties / pinterestConfigs

Added value: +{
+  "description": "Pinterest config for this item only, such as its own title or link; replaces the batch-level pinterestConfigs",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "boardId": {
+        "description": "Pinterest board ID to pin to (required)",
+        "type": "string"
+      },
+      "connectionId": {
+        "description": "Pinterest connection ID from list_accounts",
+        "type": "string"
+      },
+      "link": {
+        "description": "Destination URL for the pin",
+        "type": "string"
+      },
+      "title": {
+        "description": "Pin title (max 100 chars)",
+        "maxLength": 100,
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId",
+      "boardId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / posts / items / properties / tiktokConfigs

Added value: +{
+  "description": "TikTok config for this item only; replaces the batch-level tiktokConfigs",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "aiGenerated": {
+        "description": "Label content as AI-generated",
+        "type": "boolean"
+      },
+      "allowComments": {
+        "description": "Allow comments on the TikTok post",
+        "type": "boolean"
+      },
+      "allowDuet": {
+        "description": "Allow other users to Duet this video",
+        "type": "boolean"
+      },
+      "allowStitch": {
+        "description": "Allow other users to Stitch this video",
+        "type": "boolean"
+      },
+      "autoAddMusic": {
+        "description": "Let TikTok auto-add music to the video",
+        "type": "boolean"
+      },
+      "brandedContent": {
+        "description": "Disclose as branded content (paid partnership)",
+        "type": "boolean"
+      },
+      "brandedContentOwnBrand": {
+        "description": "Disclose as promoting your own brand",
+        "type": "boolean"
+      },
+      "caption": {
+        "description": "TikTok-specific caption (max 2200 chars)",
+        "maxLength": 2200,
+        "type": "string"
+      },
+      "connectionId": {
+        "description": "TikTok connection ID from list_accounts",
+        "type": "string"
+      },
+      "privacyLevel": {
+        "description": "TikTok privacy level",
+        "enum": [
+          "PUBLIC_TO_EVERYONE",
+          "MUTUAL_FOLLOW_FRIENDS",
+          "FOLLOWER_OF_CREATOR",
+          "SELF_ONLY"
+        ],
+        "type": "string"
+      },
+      "sendAsDraft": {
+        "description": "Save as TikTok draft so the user can add trending sounds before publishing",
+        "type": "boolean"
+      },
+      "title": {
+        "description": "Video title (max 90 chars)",
+        "maxLength": 90,
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId",
+      "privacyLevel"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / posts / items / properties / youtubeConfigs

Added value: +{
+  "description": "YouTube config for this item only, such as its own videoTitle; replaces the batch-level youtubeConfigs",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "allowEmbedding": {
+        "description": "Allow embedding the video on other sites",
+        "type": "boolean"
+      },
+      "categoryId": {
+        "description": "YouTube category ID",
+        "type": "string"
+      },
+      "connectionId": {
+        "description": "YouTube connection ID from list_accounts",
+        "type": "string"
+      },
+      "license": {
+        "description": "Video license type",
+        "enum": [
+          "youtube",
+          "creativeCommon"
+        ],
+        "type": "string"
+      },
+      "madeForKids": {
+        "description": "Mark the video as made for kids (COPPA)",
+        "type": "boolean"
+      },
+      "notifySubscribers": {
+        "description": "Notify channel subscribers about the upload",
+        "type": "boolean"
+      },
+      "playlistId": {
+        "description": "Add video to this playlist",
+        "type": "string"
+      },
+      "postType": {
+        "description": "VIDEO for long-form, SHORTS for YouTube Shorts",
+        "enum": [
+          "VIDEO",
+          "SHORTS"
+        ],
+        "type": "string"
+      },
+      "privacyStatus": {
+        "description": "Video privacy status",
+        "enum": [
+          "public",
+          "private",
+          "unlisted"
+        ],
+        "type": "string"
+      },
+      "tags": {
+        "description": "Video tags (max 20)",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array"
+      },
+      "videoTitle": {
+        "description": "YouTube video title (max 100 chars)",
+        "maxLength": 100,
+        "type": "string"
+      }
+    },
+    "required": [
+      "connectionId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / posts / maxItems
```
Added value: +100
```
addedInput schema / properties / posts / minItems
```
Added value: +1
```

addedInput schema / properties / tiktokConfigs / items / $ref

Added value: +"#/properties/posts/items/properties/tiktokConfigs/items"

removedInput schema / properties / tiktokConfigs / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / tiktokConfigs / items / properties

Removed value: -{
-  "aiGenerated": {
-    "description": "Label content as AI-generated",
-    "type": "boolean"
-  },
-  "allowComments": {
-    "description": "Allow comments on the TikTok post",
-    "type": "boolean"
-  },
-  "allowDuet": {
-    "description": "Allow other users to Duet this video",
-    "type": "boolean"
-  },
-  "allowStitch": {
-    "description": "Allow other users to Stitch this video",
-    "type": "boolean"
-  },
-  "autoAddMusic": {
-    "description": "Let TikTok auto-add music to the video",
-    "type": "boolean"
-  },
-  "brandedContent": {
-    "description": "Disclose as branded content (paid partnership)",
-    "type": "boolean"
-  },
-  "brandedContentOwnBrand": {
-    "description": "Disclose as promoting your own brand",
-    "type": "boolean"
-  },
-  "caption": {
-    "description": "TikTok-specific caption (max 2200 chars)",
-    "maxLength": 2200,
-    "type": "string"
-  },
-  "connectionId": {
-    "description": "TikTok connection ID from list_accounts",
-    "type": "string"
-  },
-  "privacyLevel": {
-    "description": "TikTok privacy level",
-    "enum": [
-      "PUBLIC_TO_EVERYONE",
-      "MUTUAL_FOLLOW_FRIENDS",
-      "FOLLOWER_OF_CREATOR",
-      "SELF_ONLY"
-    ],
-    "type": "string"
-  },
-  "sendAsDraft": {
-    "description": "Save as TikTok draft so the user can add trending sounds before publishing",
-    "type": "boolean"
-  },
-  "title": {
-    "description": "Video title (max 90 chars)",
-    "maxLength": 90,
-    "type": "string"
-  }
-}

removedInput schema / properties / tiktokConfigs / items / required
```
Removed value: -[
-  "connectionId",
-  "privacyLevel"
-]
```
removedInput schema / properties / tiktokConfigs / items / type
```
Removed value: -"object"
```

changedInput schema / properties / workspaceId / description

Previous value: -"Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another"New value: +"Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another"

addedInput schema / properties / youtubeConfigs / items / $ref

Added value: +"#/properties/posts/items/properties/youtubeConfigs/items"

removedInput schema / properties / youtubeConfigs / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / youtubeConfigs / items / properties

Removed value: -{
-  "allowEmbedding": {
-    "description": "Allow embedding the video on other sites",
-    "type": "boolean"
-  },
-  "categoryId": {
-    "description": "YouTube category ID",
-    "type": "string"
-  },
-  "connectionId": {
-    "description": "YouTube connection ID from list_accounts",
-    "type": "string"
-  },
-  "license": {
-    "description": "Video license type",
-    "enum": [
-      "youtube",
-      "creativeCommon"
-    ],
-    "type": "string"
-  },
-  "madeForKids": {
-    "description": "Mark the video as made for kids (COPPA)",
-    "type": "boolean"
-  },
-  "notifySubscribers": {
-    "description": "Notify channel subscribers about the upload",
-    "type": "boolean"
-  },
-  "playlistId": {
-    "description": "Add video to this playlist",
-    "type": "string"
-  },
-  "postType": {
-    "description": "VIDEO for long-form, SHORTS for YouTube Shorts",
-    "enum": [
-      "VIDEO",
-      "SHORTS"
-    ],
-    "type": "string"
-  },
-  "privacyStatus": {
-    "description": "Video privacy status",
-    "enum": [
-      "public",
-      "private",
-      "unlisted"
-    ],
-    "type": "string"
-  },
-  "tags": {
-    "description": "Video tags (max 20)",
-    "items": {
-      "type": "string"
-    },
-    "maxItems": 20,
-    "type": "array"
-  },
-  "videoTitle": {
-    "description": "YouTube video title (max 100 chars)",
-    "maxLength": 100,
-    "type": "string"
-  }
-}

removedInput schema / properties / youtubeConfigs / items / required
```
Removed value: -[
-  "connectionId"
-]
```
removedInput schema / properties / youtubeConfigs / items / type
```
Removed value: -"object"
```

Changed1 schema field changedSep 27, 2026

addedInput schema / properties / workspaceId

Added value: +{
+  "description": "Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another",
+  "type": "string"
+}

Changed2 schema fields changedSep 27, 2026

changedInput schema / properties / instagramConfigs / description

Previous value: -"Instagram per-connection config to set post type (FEED, REEL, STORY)"New value: +"Instagram per-connection config to set post type (FEED, REEL, STORY) and publish a reel as a trial reel"

addedInput schema / properties / instagramConfigs / items / properties / trialGraduation

Added value: +{
+  "description": "Publish a video reel as a trial reel: Instagram shows it to non-followers first and keeps it off followers' feeds and the profile grid until it is shared. MANUAL means the account owner shares it from the Instagram app; SS_PERFORMANCE means Instagram shares it if it performs well. Only for a single video posted as a reel or feed video, never a story, image or carousel (400 otherwise). Needs a professional account Instagram has enabled for trial reels; otherwise that platform fails with a message saying so",
+  "enum": [
+    "MANUAL",
+    "SS_PERFORMANCE"
+  ],
+  "type": "string"
+}

Changed1 schema field changedSep 25, 2026

changedInput schema / properties / posts / items / properties / contentType / description

Previous value: -"TEXT, IMAGE, VIDEO, or CAROUSEL; must match mediaUrls"New value: +"TEXT, IMAGE, VIDEO, or CAROUSEL; must match mediaUrls. DOCUMENT posts cannot be bulk scheduled; use create_post"

Changed3 schema fields changedSep 23, 2026

addedInput schema / properties / mastodonConnectionIds

Added value: +{
+  "description": "Mastodon account connection IDs to post from",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / platforms / items / enum

Previous value: -[
-  "LINKEDIN",
-  "YOUTUBE",
-  "INSTAGRAM",
-  "FACEBOOK",
-  "TIKTOK",
-  "PINTEREST",
-  "THREADS",
-  "BLUESKY",
-  "TWITTER"
-]New value: +[
+  "LINKEDIN",
+  "YOUTUBE",
+  "INSTAGRAM",
+  "FACEBOOK",
+  "TIKTOK",
+  "PINTEREST",
+  "THREADS",
+  "BLUESKY",
+  "TWITTER",
+  "MASTODON"
+]

changedInput schema / properties / posts / items / properties / mediaAltTexts / description

Previous value: -"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it"New value: +"Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it"

Changed1 schema field changedSep 19, 2026

addedInput schema / properties / posts / items / properties / mediaAltTexts

Added value: +{
+  "description": "Alt text per image, in the same order as mediaUrls (max 1000 characters each; use \"\" to skip an image). Sent to X, Bluesky, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube and videos ignore it",
+  "items": {
+    "maxLength": 1000,
+    "type": "string"
+  },
+  "type": "array"
+}

Changed11 schema fields changedSep 8, 2026

changedInput schema / properties / facebookConfigs / description

Previous value: -"Facebook per-page config with post type and video title"New value: +"Facebook per-page config with post type and video title. pageId must match an entry in pageIds"

changedInput schema / properties / pageIds / description

Previous value: -"Facebook page IDs"New value: +"Facebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array"

changedInput schema / properties / pinterestConfigs / description

Previous value: -"Pinterest per-connection config. boardId is required for Pinterest posts"New value: +"Pinterest per-connection config. Each entry needs connectionId + boardId; there is no API to list boards, so ask the user for the board id"

changedInput schema / properties / platforms / description

Previous value: -"Target platforms"New value: +"Target platforms shared by every item. Each needs its connection-id array (pageIds for FACEBOOK)"

changedInput schema / properties / posts / description

Previous value: -"Array of posts to schedule"New value: +"1 to 100 posts to schedule; each is created independently"

addedInput schema / properties / posts / items / properties / contentType / description
```
Added value: +"TEXT, IMAGE, VIDEO, or CAROUSEL; must match mediaUrls"
```

changedInput schema / properties / posts / items / properties / mediaUrls / description

Previous value: -"Image or video URLs to attach"New value: +"publicUrl values from upload_media; unstored URLs fail this item"

addedInput schema / properties / posts / items / properties / platformTexts / description
```
Added value: +"Per-platform caption overrides for this item"
```

changedInput schema / properties / posts / items / properties / scheduledAt / description

Previous value: -"ISO 8601 schedule time"New value: +"Absolute ISO 8601 instant; a past time publishes immediately"

changedInput schema / properties / timezone / description

Previous value: -"IANA timezone"New value: +"IANA timezone stored with every post for display; does not shift scheduledAt"

changedOutput schema / properties / result / description

Previous value: -"The created scheduled post records with their ids, statuses, and schedule times as returned by the AdaptlyPost API."New value: +"An object with totalScheduled, totalFailed, and results: one { postId, success, isScheduled, scheduledAt, errorMessage } per input item, in input order."

First observedSep 1, 2026

TDQS

Score is being calculated.

All AdaptlyPost tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?