Skip to main content
Glama

Create Post

create_post
Destructive

Create one post on the user's own connected social accounts. saveAsDraft saves a DRAFT and publishes nothing; a scheduledAt sent with it becomes the draft's planned date, which publish_draft later schedules. Without saveAsDraft, a future scheduledAt schedules the post; otherwise it publishes now. Before publishing or scheduling, show the user the final text, media, accounts and time (or repeat schedule) and get their confirmation; a draft needs no confirmation. Account ids come from list_accounts (pass them as accountIds, or as platforms plus the per-platform arrays) and mediaUrls from upload_media. Platform-specific options (TikTok privacy, Pinterest board, LinkedIn document or reshare, Google Business event or offer, Tumblr tags, WordPress title, excerpt, categories, tags and whether the site gets a live post, a draft or a post pending review, YouTube audio language and scheduling on YouTube, Instagram user tags, Facebook link carousel, first comments, threads of replies, different media for one platform, recurrence) are described on each field. To find every problem before creating anything, call validate_post with the same input first. Publishing runs per platform in the background, so the response ({ postId, queuedPlatforms, isScheduled, scheduledAt }) is not the outcome; check list_post_results. Each call creates a separate post, so after an error or timeout check list_posts before trying again. Use update_post or publish_draft for an existing post and bulk_schedule_posts for many posts.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "contentType": "<contentType>"
    },
    "name": "create_post"
  }
}

Input Schema

NameRequiredDescriptionDefault
textNoDefault post text shared across platforms. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it
pageIdsNoFacebook page account ids from list_accounts (the account id; its pageId value is also accepted). Facebook has no connection-id array
timezoneNoIANA timezone stored with the post for display (e.g. "America/New_York"); it does not shift scheduledAtUTC
mediaUrlsNoMedia URLs to attach. Use publicUrl values from upload_media or get_upload_urls; the same publicUrl may be reused across posts. Do not reuse mediaUrls read back from a published post, which may be expiring platform links
platformsNoTarget platforms (e.g. ["LINKEDIN", "TWITTER"]). Each one needs its matching connection-id array (pageIds for FACEBOOK, googleBusinessConnectionIds for GOOGLE_BUSINESS) filled with ids from list_accounts. Optional when accountIds is sent
accountIdsNoAccount ids (or Facebook pageIds) from list_accounts to post to. AdaptlyPost adds each account's platform to platforms and its id to the matching connection-id array, so you can send these instead of platforms and the per-platform arrays, or alongside them. An id not connected to the workspace fails with 400
recurrenceNoRepeat the post on a schedule the user asked for, and confirm that schedule with them first. Needs a future scheduledAt, which becomes the first post and sets the time of day in timezone. Cannot be combined with saveAsDraft or TIKTOK. Missed slots, for example while paused, are skipped and never published late. The user can pause or stop the series at any time with pause_recurring_post or delete_recurring_post; list_recurring_posts shows it
contentTypeYesWhat the post carries; it must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on TWITTER, LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs
saveAsDraftNoSave as DRAFT instead of publishing or scheduling; publish later with publish_draft. A scheduledAt sent with it is stored as the draft's planned date, and publish_draft schedules the draft for that date
scheduledAtNoAbsolute ISO 8601 instant to schedule (e.g. "2026-03-15T10:00:00Z"). Omit to post immediately; a past time also posts immediately. With saveAsDraft it is the draft's planned date instead: nothing is scheduled, and publish_draft without a date later schedules the draft for it
workspaceIdNoWorkspace 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
thumbnailUrlNoVideo thumbnail as an https URL or an image data URI, used on every platform that takes one unless platformThumbnails overrides it
firstCommentsNoA comment posted from the same account shortly after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment goes out within about a minute of the platform publishing (about two minutes on YouTube), or within about a minute of delayMinutes after it when the entry sets one, and is retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones
mediaAltTextsNoAlt text per image, in the same order as mediaUrls (use "" to skip an image). Sent to X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it
platformMediaNoDifferent media for one platform, for when the post media does not fit it (a video too long for TikTok, a carousel with more images than X takes), one entry per platform. A platform without an entry uses the post mediaUrls. The entry must match the post contentType: one video for VIDEO, one image for IMAGE, one document for DOCUMENT, two or more items for CAROUSEL; TEXT posts take none. Each entry is checked against its own platform's limits only, and the post mediaUrls is no longer checked against that platform. An entry for a platform the post does not go to, an empty mediaUrls, a data URI, a second entry for one platform and media of another type are refused with 400. An overridden platform does not use the post-level thumbnailUrl or thumbnailTimestampMs; give it its own through platformThumbnails. On an update, sending the array replaces every override, [] clears them all and omitting it keeps the stored ones; it takes effect even without platforms. get_post shows an override as mediaOverrideUrls and mediaOverrideAltTexts on that platform
platformTextsNoPer-platform caption overrides
threadRepliesNoTurns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. A reply can carry up to 4 images (JPEG, PNG, GIF or WEBP) through mediaUrls, adapted to the platform like the post's own images; a reply with images may leave its text empty. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, a reply with neither text nor images, a too long reply, more than 25 replies, more than 4 images or a video on a reply, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones
tiktokConfigsNoTikTok per-connection config. Each entry needs connectionId + privacyLevel at minimum
tumblrConfigsNoTumblr per-blog config: tags, a title and a source link. connectionId must match an entry in tumblrConnectionIds
twitterConfigsNoX per-connection config: quoteOf quotes one of the account's own posts with the text as commentary. connectionId must match an entry in twitterConnectionIds
youtubeConfigsNoYouTube per-connection config with video title, tags, privacy, etc.
facebookConfigsNoFacebook per-page config: post type, shareToStory, video title, text background, a grid or link carousel for several images, and the AI info label. pageId must match an entry in pageIds
linkedinConfigsNoLinkedIn per-connection config: documentTitle names a DOCUMENT post, reshareOf reshares another LinkedIn post with the text as commentary. connectionId must match an entry in linkedinConnectionIds
instagramConfigsNoInstagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, user tags, the AI info label, Reel audio, and trial reels
pinterestConfigsNoPinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId, or pass the board name as boardName instead (not both); a board belongs to one Pinterest account. A boardName that matches no board or several fails with 400. Without either the pin goes to a board named AdaptlyPost
twitterKeepLinksNoKeep links in the X text clickable. X charges over 10 times more for a post with a link, so by default every link in X text is broken (example.com becomes example. com). Only AppSumo lifetime deals can turn this on, and a kept link costs 20 credits instead of 2. true on any other plan is refused with 400; it is ignored when the X text has no link
wordpressConfigsNoWordPress per-site config: title, excerpt, categories, tags and status (publish, leave a draft or submit for review). connectionId must match an entry in wordpressConnectionIds
platformThumbnailsNoA different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST and TELEGRAM take an image (thumbnailUrl) or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones
tiktokConnectionIdsNoTikTok account connection IDs to post from
tumblrConnectionIdsNoTumblr blogs to post to, by the account id from list_accounts. TUMBLR takes text up to 32768 characters, up to 30 JPEG, PNG or GIF images (10 MB each) or one MP4 video (500 MB, up to 10 minutes), and alt text; it has no first comments, threads, per-platform thumbnails, image shapes or analytics
blueskyConnectionIdsNoBluesky account connection IDs to post from
platformAspectRatiosNoReframe every image of an IMAGE or CAROUSEL post to one shape on a platform, one entry per platform. INSTAGRAM takes SQUARE, PORTRAIT or LANDSCAPE (Instagram refuses 9:16 feed and carousel images); TIKTOK takes all four. Video posts, Instagram stories and a second entry for the same platform are refused with 400. Omit a platform to keep its images as uploaded. On an update it applies to the mediaUrls sent in the same request
threadsConnectionIdsNoThreads account connection IDs to post from
thumbnailTimestampMsNoVideo frame timestamp (ms) to use as the thumbnail on every platform that takes one: YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM and TIKTOK. A thumbnailUrl sent with it wins everywhere except TIKTOK, which takes only a frame, and platformThumbnails overrides both
twitterConnectionIdsNoX (Twitter) account connection IDs to post from
youtubeConnectionIdsNoYouTube channel connection IDs to post from
googleBusinessConfigsNoGoogle Business Profile per-location config: update, event or offer, plus a button. connectionId must match an entry in googleBusinessConnectionIds. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters
linkedinConnectionIdsNoLinkedIn account connection IDs to post from
mastodonConnectionIdsNoMastodon account connection IDs to post from
telegramConnectionIdsNoTelegram channels and groups to post to, by the account id from list_accounts. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media
instagramConnectionIdsNoInstagram account connection IDs to post from
pinterestConnectionIdsNoPinterest account connection IDs to post from
wordpressConnectionIdsNoWordPress sites to post to, by the account id from list_accounts. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. A site without an entry in wordpressConfigs uses the first line of the text as the title. WordPress has no first comments, threads, thumbnails, image shapes or analytics
googleBusinessConnectionIdsNoGoogle Business Profile locations to post to, by the account id from list_accounts. A location without an entry in googleBusinessConfigs gets a STANDARD update

Output Schema

NameRequiredDescriptionDefault
resultYesAn object with postId, queuedPlatforms (platforms whose publishing job was queued; empty for scheduled posts and drafts), skippedPlatforms, isScheduled, and scheduledAt, plus recurringPostId when recurrence was sent. Publishing is asynchronous: check list_post_results for outcomes.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / firstComments / description
      Previous value: -"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"New value: +"A comment posted from the same account shortly after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment goes out within about a minute of the platform publishing (about two minutes on YouTube), or within about a minute of delayMinutes after it when the entry sets one, and is retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"
    • addedInput schema / properties / firstComments / items / properties / delayMinutes
      Added value: +{
      +  "description": "How many minutes after the platform publishes to post the comment, up to 10080 (7 days). Omit it or send 0 for no delay. The comment goes out within about a minute of that time; without a delay, within about a minute of the post (about two minutes on YouTube). Once the post is published the delay cannot be changed; deleting the post cancels a comment that has not gone out yet",
      +  "maximum": 10080,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  2. Changed3 schema fields changed
    • changedInput schema / properties / contentType / description
      Previous value: -"What the post carries; it must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"What the post carries; it must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on TWITTER, LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"
    • changedInput schema / properties / wordpressConfigs / description
      Previous value: -"WordPress per-site config: title, excerpt, categories and tags. connectionId must match an entry in wordpressConnectionIds"New value: +"WordPress per-site config: title, excerpt, categories, tags and status (publish, leave a draft or submit for review). connectionId must match an entry in wordpressConnectionIds"
    • addedInput schema / properties / wordpressConfigs / items / properties / status
      Added value: +{
      +  "description": "What the post becomes on the site at the post's time. PUBLISH (default) publishes it live. DRAFT leaves a WordPress draft the user finishes and publishes or schedules in WordPress. PENDING submits it for review (Pending Review). Unrelated to saveAsDraft: the post must still be published or scheduled to reach the site. For DRAFT and PENDING the post's postUrl opens it in the WordPress editor",
      +  "enum": [
      +    "PUBLISH",
      +    "DRAFT",
      +    "PENDING"
      +  ],
      +  "type": "string"
      +}
  3. Changed3 schema fields changed
    • changedInput schema / properties / instagramConfigs / items / properties / audio / properties / audioVolume / description
      Previous value: -"Volume of the added audio, where 100 is full volume. Defaults to 100"New value: +"How loud the added audio plays, as a percentage of its full volume. Omit for full volume"
    • changedInput schema / properties / instagramConfigs / items / properties / audio / properties / videoVolume / description
      Previous value: -"Volume of the video's own sound, where 100 is full volume. Defaults to 100"New value: +"How loud the video's own sound plays under the added audio, as a percentage of its full volume. Omit for full volume"
    • changedInput schema / properties / tiktokConfigs / items / properties / caption / description
      Previous value: -"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post (where it is the description). Falls back to title, then to the post text. A video sent with sendAsDraft can reach the TikTok inbox without it, because TikTok's inbox upload takes no caption"New value: +"TikTok-specific caption, used instead of the post text. TikTok caps it at 2200 characters on a video; on a photo or photo carousel post it is the description and can use the full length. Falls back to title, then to the post text. A video sent with sendAsDraft can reach the TikTok inbox without it, because TikTok's inbox upload takes no caption"
  4. Changed41 schema fields changed
    • changedInput schema / properties / contentType / description
      Previous value: -"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"What the post carries; it must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. Give a platform with a lower limit its own items through platformMedia. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"
    • changedInput schema / properties / facebookConfigs / items / properties / videoTitle / description
      Previous value: -"Video title for Facebook (max 255 chars)"New value: +"Title shown on the Facebook video"
    • addedInput schema / properties / firstComments / items / properties / platform / description
      Added value: +"The platform whose published post gets this comment"
    • changedInput schema / properties / googleBusinessConfigs / items / properties / callToActionUrl / description
      Previous value: -"Ignored when callToActionType is CALL"New value: +"Page the button opens. Ignored when callToActionType is CALL"
    • changedInput schema / properties / googleBusinessConfigs / items / properties / eventEnd / description
      Previous value: -"YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T21:00\")"New value: +"End of the event or offer in the business's local time with no offset, as a date or a date and time (e.g. \"2026-10-01T21:00\")"
    • changedInput schema / properties / googleBusinessConfigs / items / properties / eventStart / description
      Previous value: -"YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T18:00\"). Google reads event times in the location's time zone"New value: +"Start of the event or offer in the business's local time with no offset, as a date or a date and time (e.g. \"2026-10-01T18:00\"). Google reads event times in the location's time zone"
    • changedInput schema / properties / instagramConfigs / items / properties / audio / properties / audioVolume / description
      Previous value: -"Volume of the added audio, 1 to 100. Defaults to 100"New value: +"Volume of the added audio, where 100 is full volume. Defaults to 100"
    • changedInput schema / properties / instagramConfigs / items / properties / audio / properties / videoVolume / description
      Previous value: -"Volume of the video's own sound, 1 to 100. Defaults to 100"New value: +"Volume of the video's own sound, where 100 is full volume. Defaults to 100"
    • changedInput schema / properties / instagramConfigs / items / properties / collaborators / description
      Previous value: -"Instagram usernames invited as collaborators (Instagram Collab), up to 3. A leading @ is stripped and duplicates are dropped. Works on feed images, carousels and reels; a story or a trial reel with collaborators is refused with 400. Each collaborator gets an invite in Instagram and must accept it before the post shows on their profile"New value: +"Instagram usernames invited as collaborators (Instagram Collab). A leading @ is stripped and duplicates are dropped. Works on feed images, carousels and reels; a story or a trial reel with collaborators is refused with 400. Each collaborator gets an invite in Instagram and must accept it before the post shows on their profile"
    • changedInput schema / properties / instagramConfigs / items / properties / userTags / description
      Previous value: -"Public Instagram accounts tagged in the media, up to 20. Works on a single image, a single video (published as a Reel) or a single story; a carousel or several stories with tags is refused with 400. On a feed image every tag needs x and y; on a story they are optional, and on a video they are ignored because the person is tagged on the video as a whole. A leading @ is stripped and a repeated username keeps its first entry. If Instagram refuses a tag because the account is private or does not exist, the post goes out without its tags and instagramUntaggedUsernames in get_post lists the refused usernames"New value: +"Public Instagram accounts tagged in the media. Works on a single image, a single video (published as a Reel) or a single story; a carousel or several stories with tags is refused with 400. On a feed image every tag needs x and y; on a story they are optional, and on a video they are ignored because the person is tagged on the video as a whole. A leading @ is stripped and a repeated username keeps its first entry. If Instagram refuses a tag because the account is private or does not exist, the post goes out without its tags and instagramUntaggedUsernames in get_post lists the refused usernames"
    • changedInput schema / properties / instagramConfigs / items / properties / userTags / items / properties / x / description
      Previous value: -"Horizontal position of the tag on the image, from 0 (left edge) to 1 (right edge)"New value: +"Horizontal position of the tag as a fraction of the image width, where 0 is the left edge"
    • changedInput schema / properties / instagramConfigs / items / properties / userTags / items / properties / y / description
      Previous value: -"Vertical position of the tag on the image, from 0 (top edge) to 1 (bottom edge)"New value: +"Vertical position of the tag as a fraction of the image height, where 0 is the top edge"
    • changedInput schema / properties / linkedinConfigs / items / properties / documentTitle / description
      Previous value: -"Title LinkedIn shows on a DOCUMENT post (max 100 chars). Defaults to the file name; ignored for other content types"New value: +"Title LinkedIn shows on a DOCUMENT post. Defaults to the file name; ignored for other content types"
    • changedInput schema / 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, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"New value: +"Alt text per image, in the same order as mediaUrls (use \"\" to skip an image). Sent to X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"
    • changedInput schema / properties / pinterestConfigs / items / properties / title / description
      Previous value: -"Pin title (max 100 chars)"New value: +"Title shown on the pin"
    • addedInput schema / properties / platformAspectRatios / items / properties / platform / description
      Added value: +"The platform whose images are reframed to aspectRatio"
    • addedInput schema / properties / platformMedia
      Added value: +{
      +  "description": "Different media for one platform, for when the post media does not fit it (a video too long for TikTok, a carousel with more images than X takes), one entry per platform. A platform without an entry uses the post mediaUrls. The entry must match the post contentType: one video for VIDEO, one image for IMAGE, one document for DOCUMENT, two or more items for CAROUSEL; TEXT posts take none. Each entry is checked against its own platform's limits only, and the post mediaUrls is no longer checked against that platform. An entry for a platform the post does not go to, an empty mediaUrls, a data URI, a second entry for one platform and media of another type are refused with 400. An overridden platform does not use the post-level thumbnailUrl or thumbnailTimestampMs; give it its own through platformThumbnails. On an update, sending the array replaces every override, [] clears them all and omitting it keeps the stored ones; it takes effect even without platforms. get_post shows an override as mediaOverrideUrls and mediaOverrideAltTexts on that platform",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "mediaAltTexts": {
      +        "description": "Alt text per item, in the same order as this entry's mediaUrls (use \"\" to skip one)",
      +        "items": {
      +          "maxLength": 1000,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "mediaUrls": {
      +        "description": "This platform's media, publicUrl values from upload_media or get_upload_urls. Public https URLs only, no data URIs",
      +        "items": {
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "platform": {
      +        "description": "The platform that publishes this media instead of the post mediaUrls",
      +        "enum": [
      +          "LINKEDIN",
      +          "YOUTUBE",
      +          "INSTAGRAM",
      +          "FACEBOOK",
      +          "TIKTOK",
      +          "PINTEREST",
      +          "THREADS",
      +          "BLUESKY",
      +          "TWITTER",
      +          "MASTODON",
      +          "GOOGLE_BUSINESS",
      +          "TUMBLR",
      +          "WORDPRESS",
      +          "TELEGRAM"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "platform",
      +      "mediaUrls"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / platformTexts / items / properties / platform / $ref
      Removed value: -"#/properties/platforms/items"
    • addedInput schema / properties / platformTexts / items / properties / platform / description
      Added value: +"The platform that gets this text instead of the post text; one entry per platform"
    • addedInput schema / properties / platformTexts / items / properties / platform / enum
      Added value: +[
      +  "LINKEDIN",
      +  "YOUTUBE",
      +  "INSTAGRAM",
      +  "FACEBOOK",
      +  "TIKTOK",
      +  "PINTEREST",
      +  "THREADS",
      +  "BLUESKY",
      +  "TWITTER",
      +  "MASTODON",
      +  "GOOGLE_BUSINESS",
      +  "TUMBLR",
      +  "WORDPRESS",
      +  "TELEGRAM"
      +]
    • addedInput schema / properties / platformTexts / items / properties / platform / type
      Added value: +"string"
    • addedInput schema / properties / platformThumbnails / items / properties / platform / description
      Added value: +"The platform that uses this thumbnail instead of the post-level one"
    • changedInput schema / properties / recurrence / properties / frequency / description
      Previous value: -"How often the post repeats: DAILY, WEEKLY, MONTHLY or YEARLY. YEARLY repeats on the same date; a series started on February 29 posts on February 28 in other years"New value: +"How often the post repeats. YEARLY repeats on the same date; a series started on February 29 posts on February 28 in other years"
    • changedInput schema / properties / recurrence / properties / interval / description
      Previous value: -"Repeat every N days, weeks, months or years, 1 to 30 (default 1)"New value: +"Repeat every N periods of frequency, so 2 with WEEKLY is every other week (default 1)"
    • changedInput schema / properties / recurrence / properties / maxOccurrences / description
      Previous value: -"Total number of posts the series publishes, 2 to 365. Cannot be combined with endsOn; omit both to repeat until the user pauses or deletes the series"New value: +"Total number of posts the series publishes. Cannot be combined with endsOn; omit both to repeat until the user pauses or deletes the series"
    • changedInput schema / properties / threadReplies / items / properties / mediaUrls / description
      Previous value: -"Parallel to texts: the image URLs of each reply, from upload_media, and [] for a reply without images. Up to 4 JPEG, PNG, GIF or WEBP images per reply"New value: +"Parallel to texts: the JPEG, PNG, GIF or WEBP image URLs of each reply, from upload_media, and [] for a reply without images"
    • addedInput schema / properties / threadReplies / items / properties / platform / description
      Added value: +"The platform whose published post these replies follow"
    • changedInput schema / properties / tiktokConfigs / items / properties / privacyLevel / description
      Previous value: -"TikTok privacy level"New value: +"Who can see the TikTok post: everyone, mutual followers, followers of the creator, or only the creator (SELF_ONLY)"
    • changedInput schema / properties / tiktokConfigs / items / properties / title / description
      Previous value: -"Max 90 characters. On a photo post, the title shown above the description. On a video, sent as the caption only when caption is empty"New value: +"On a photo post, the title shown above the description. On a video, sent as the caption only when caption is empty"
    • changedInput schema / properties / tumblrConfigs / items / properties / tags / description
      Previous value: -"Tumblr tags, up to 30, each up to 140 characters and without commas. A leading # is stripped and duplicates are dropped, ignoring case"New value: +"Tags shown on the Tumblr post. A leading # is stripped and duplicates are dropped, ignoring case"
    • changedInput schema / properties / wordpressConfigs / items / properties / tags / description
      Previous value: -"Tag names, up to 50. A tag the site does not have yet is created when the WordPress user may manage tags, and skipped otherwise"New value: +"WordPress tag names. A tag the site does not have yet is created when the WordPress user may manage tags, and skipped otherwise"
    • changedInput schema / properties / youtubeConfigs / items / properties / categoryId / description
      Previous value: -"YouTube category ID"New value: +"Numeric YouTube video category id, as a string, such as \"22\" for People & Blogs"
    • changedInput schema / properties / youtubeConfigs / items / properties / license / description
      Previous value: -"Video license type"New value: +"youtube is the standard YouTube license; creativeCommon publishes the video under Creative Commons Attribution so others may reuse it"
    • changedInput schema / properties / youtubeConfigs / items / properties / playlistId / description
      Previous value: -"Add video to this playlist"New value: +"Id of a playlist on this YouTube channel; the uploaded video is added to it"
    • changedInput schema / properties / youtubeConfigs / items / properties / privacyStatus / description
      Previous value: -"Video privacy status"New value: +"Who can watch the video: public is everyone, unlisted is anyone with the link, private is only the channel"
    • changedInput schema / properties / youtubeConfigs / items / properties / tags / description
      Previous value: -"Video tags (max 20)"New value: +"Keyword tags stored on the YouTube video"
    • changedInput schema / properties / youtubeConfigs / items / properties / videoTitle / description
      Previous value: -"YouTube video title (max 100 chars)"New value: +"Title of the YouTube video"
    • addedOutput schema / properties / result / additionalProperties
      Added value: +true
    • addedOutput schema / properties / result / properties
      Added value: +{
      +  "isScheduled": {
      +    "type": [
      +      "boolean",
      +      "null"
      +    ]
      +  },
      +  "postId": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "queuedPlatforms": {
      +    "anyOf": [
      +      {
      +        "items": {
      +          "description": "One of: FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, LINKEDIN, PINTEREST, YOUTUBE, MASTODON, TELEGRAM, GOOGLE_BUSINESS, TUMBLR, WORDPRESS",
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "recurringPostId": {
      +    "description": "Set when the request carried `recurrence`",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "scheduledAt": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "skippedPlatforms": {
      +    "anyOf": [
      +      {
      +        "items": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "platform": {
      +              "description": "One of: FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, LINKEDIN, PINTEREST, YOUTUBE, MASTODON, TELEGRAM, GOOGLE_BUSINESS, TUMBLR, WORDPRESS",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "reason": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  }
      +}
    • addedOutput schema / properties / result / type
      Added value: +"object"
    • addedOutput schema / required
      Added value: +[
      +  "result"
      +]
  5. Changed9 schema fields changed
    • changedInput schema / properties / firstComments / description
      Previous value: -"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"New value: +"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"
    • changedInput schema / properties / firstComments / items / properties / platform / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "TWITTER",
      -  "BLUESKY",
      -  "MASTODON",
      -  "YOUTUBE",
      -  "FACEBOOK",
      -  "INSTAGRAM"
      -]New value: +[
      +  "LINKEDIN",
      +  "TWITTER",
      +  "THREADS",
      +  "BLUESKY",
      +  "MASTODON",
      +  "YOUTUBE",
      +  "FACEBOOK",
      +  "INSTAGRAM"
      +]
    • addedInput schema / properties / threadReplies / items / properties / texts / items / maxLength
      Added value: +25000
    • changedInput schema / properties / tiktokConfigs / items / properties / caption / description
      Previous value: -"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post"New value: +"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post (where it is the description). Falls back to title, then to the post text. A video sent with sendAsDraft can reach the TikTok inbox without it, because TikTok's inbox upload takes no caption"
    • changedInput schema / properties / tiktokConfigs / items / properties / title / description
      Previous value: -"Video title (max 90 chars)"New value: +"Max 90 characters. On a photo post, the title shown above the description. On a video, sent as the caption only when caption is empty"
    • changedInput schema / properties / tumblrConfigs / items / properties / tags / description
      Previous value: -"Tumblr tags, without commas, up to 30. A leading # is stripped and duplicates are dropped, ignoring case"New value: +"Tumblr tags, up to 30, each up to 140 characters and without commas. A leading # is stripped and duplicates are dropped, ignoring case"
    • addedInput schema / properties / tumblrConfigs / items / properties / tags / items / maxLength
      Added value: +140
    • addedInput schema / properties / tumblrConfigs / items / properties / tags / items / pattern
      Added value: +"^[^,]+$"
    • addedInput schema / properties / youtubeConfigs / items / properties / scheduleOnYouTube
      Added value: +{
      +  "description": "Upload the video as soon as the post is scheduled, as a private video that YouTube publishes itself at scheduledAt, so the user can set up a Test & Compare (thumbnail and title A/B test) in YouTube Studio before it goes public. privacyStatus must be public or omitted (400 YOUTUBE_SCHEDULE_REQUIRES_PUBLIC), and a recurring post is refused (400 YOUTUBE_SCHEDULE_NOT_RECURRING). With a scheduledAt less than 15 minutes ahead the video uploads at scheduledAt as usual. Once the video is on YouTube (youtubeScheduledVideoId is set on the platform), the post cannot be updated, unscheduled or published early (409 SCHEDULED_ON_YOUTUBE); to change it, delete it and schedule it again. Deleting it before scheduledAt also deletes the video from YouTube",
      +  "type": "boolean"
      +}
  6. Changed3 schema fields changed
    • changedInput schema / properties / threadReplies / description
      Previous value: -"Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, an empty or too long reply, more than 25 replies, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones"New value: +"Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. A reply can carry up to 4 images (JPEG, PNG, GIF or WEBP) through mediaUrls, adapted to the platform like the post's own images; a reply with images may leave its text empty. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, a reply with neither text nor images, a too long reply, more than 25 replies, more than 4 images or a video on a reply, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones"
    • addedInput schema / properties / threadReplies / items / properties / mediaUrls
      Added value: +{
      +  "description": "Parallel to texts: the image URLs of each reply, from upload_media, and [] for a reply without images. Up to 4 JPEG, PNG, GIF or WEBP images per reply",
      +  "items": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "maxItems": 4,
      +    "type": "array"
      +  },
      +  "maxItems": 25,
      +  "type": "array"
      +}
    • changedInput schema / properties / threadReplies / items / properties / platform / enum
      Previous value: -[
      -  "TWITTER",
      -  "BLUESKY",
      -  "MASTODON"
      -]New value: +[
      +  "TWITTER",
      +  "THREADS",
      +  "BLUESKY",
      +  "MASTODON"
      +]
  7. Changed1 schema field changed
    • addedInput schema / properties / twitterConfigs
      Added value: +{
      +  "description": "X per-connection config: quoteOf quotes one of the account's own posts with the text as commentary. connectionId must match an entry in twitterConnectionIds",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "connectionId": {
      +        "description": "X connection ID from list_accounts",
      +        "type": "string"
      +      },
      +      "quoteOf": {
      +        "description": "Quote one of this account's own X posts, with the post text as the commentary. Takes a post link such as https://x.com/<handle>/status/<id> or the post's numeric id, such as the platformPostId from list_post_results. X only lets an account quote posts it wrote or posts that mention it: a link naming another handle is refused with 400, and any other post fails when it publishes. Needs text, and media on the post is not attached on this account. Costs the same as any X post",
      +        "maxLength": 200,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "connectionId"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  8. Changed2 schema fields changed
    • changedInput schema / properties / facebookConfigs / description
      Previous value: -"Facebook per-page config: post type, shareToStory, video title, text background, and a grid or link carousel for several images. pageId must match an entry in pageIds"New value: +"Facebook per-page config: post type, shareToStory, video title, text background, a grid or link carousel for several images, and the AI info label. pageId must match an entry in pageIds"
    • addedInput schema / properties / facebookConfigs / items / properties / aiGenerated
      Added value: +{
      +  "description": "Disclose that the post was made or edited with AI. Facebook shows its \"AI info\" label on the post. Works on every contentType VIDEO post, whatever its postType: Facebook publishes every video as a reel, and a video story carries the label too. Photos, carousels and text posts are rejected with a 400. Omit it or send false for no label",
      +  "type": "boolean"
      +}
  9. Changed14 schema fields changed
    • changedInput schema / properties / contentType / description
      Previous value: -"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN and WORDPRESS, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"
    • changedInput schema / properties / firstComments / description
      Previous value: -"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"New value: +"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"
    • changedInput schema / properties / firstComments / items / properties / platform / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "TWITTER",
      -  "THREADS",
      -  "BLUESKY",
      -  "MASTODON",
      -  "YOUTUBE",
      -  "FACEBOOK",
      -  "INSTAGRAM"
      -]New value: +[
      +  "LINKEDIN",
      +  "TWITTER",
      +  "BLUESKY",
      +  "MASTODON",
      +  "YOUTUBE",
      +  "FACEBOOK",
      +  "INSTAGRAM"
      +]
    • changedInput schema / 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, Mastodon, Tumblr, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile 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, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"
    • changedInput schema / properties / platformThumbnails / description
      Previous value: -"A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, LINKEDIN and TELEGRAM take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones"New value: +"A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST and TELEGRAM take an image (thumbnailUrl) or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones"
    • changedInput schema / properties / platforms / items / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "YOUTUBE",
      -  "INSTAGRAM",
      -  "FACEBOOK",
      -  "TIKTOK",
      -  "PINTEREST",
      -  "THREADS",
      -  "BLUESKY",
      -  "TWITTER",
      -  "MASTODON",
      -  "GOOGLE_BUSINESS",
      -  "TUMBLR",
      -  "TELEGRAM"
      -]New value: +[
      +  "LINKEDIN",
      +  "YOUTUBE",
      +  "INSTAGRAM",
      +  "FACEBOOK",
      +  "TIKTOK",
      +  "PINTEREST",
      +  "THREADS",
      +  "BLUESKY",
      +  "TWITTER",
      +  "MASTODON",
      +  "GOOGLE_BUSINESS",
      +  "TUMBLR",
      +  "WORDPRESS",
      +  "TELEGRAM"
      +]
    • changedInput schema / properties / threadReplies / description
      Previous value: -"Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, an empty or too long reply, more than 25 replies, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones"New value: +"Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, an empty or too long reply, more than 25 replies, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones"
    • changedInput schema / properties / threadReplies / items / properties / platform / enum
      Previous value: -[
      -  "TWITTER",
      -  "THREADS",
      -  "BLUESKY",
      -  "MASTODON"
      -]New value: +[
      +  "TWITTER",
      +  "BLUESKY",
      +  "MASTODON"
      +]
    • changedInput schema / properties / thumbnailTimestampMs / description
      Previous value: -"Video frame timestamp (ms) to use as the thumbnail, used by INSTAGRAM, PINTEREST and TIKTOK unless platformThumbnails overrides it"New value: +"Video frame timestamp (ms) to use as the thumbnail on every platform that takes one: YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM and TIKTOK. A thumbnailUrl sent with it wins everywhere except TIKTOK, which takes only a frame, and platformThumbnails overrides both"
    • changedInput schema / properties / tiktokConfigs / items / properties / caption / description
      Previous value: -"TikTok-specific caption (max 2200 chars)"New value: +"TikTok-specific caption: up to 2200 characters on a video, 4000 on a photo or photo carousel post"
    • changedInput schema / properties / tiktokConfigs / items / properties / caption / maxLength
      Previous value: -2200New value: +4000
    • addedInput schema / properties / wordpressConfigs
      Added value: +{
      +  "description": "WordPress per-site config: title, excerpt, categories and tags. connectionId must match an entry in wordpressConnectionIds",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "categoryIds": {
      +        "description": "Category ids from list_wordpress_categories for this site. Omitted, WordPress files the post under the site's default category",
      +        "items": {
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "maxItems": 50,
      +        "type": "array"
      +      },
      +      "connectionId": {
      +        "description": "WordPress site account id from list_accounts",
      +        "type": "string"
      +      },
      +      "excerpt": {
      +        "description": "Summary WordPress shows in post lists and feeds",
      +        "maxLength": 1000,
      +        "type": "string"
      +      },
      +      "tags": {
      +        "description": "Tag names, up to 50. A tag the site does not have yet is created when the WordPress user may manage tags, and skipped otherwise",
      +        "items": {
      +          "maxLength": 100,
      +          "type": "string"
      +        },
      +        "maxItems": 50,
      +        "type": "array"
      +      },
      +      "title": {
      +        "description": "Post title. Defaults to the first line of the text, cut to 100 characters",
      +        "maxLength": 300,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "connectionId"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / wordpressConnectionIds
      Added value: +{
      +  "description": "WordPress sites to post to, by the account id from list_accounts. WORDPRESS publishes the text as the body of a blog post, up to 100,000 characters: blank lines start new paragraphs and bare links become clickable. It takes up to 20 JPEG, PNG, WebP or GIF images (20 MB each) or one MP4 or MOV video (500 MB); the first image is the featured image and the other images or the video follow the text. A site without an entry in wordpressConfigs uses the first line of the text as the title. WordPress has no first comments, threads, thumbnails, image shapes or analytics",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / youtubeConfigs / items / properties / defaultAudioLanguage
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 35,
      +      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Language spoken in the video's original audio, as a BCP-47 tag such as en, pt-BR or es-419, so YouTube does not treat it as another language. null clears a saved value. It does not turn off YouTube's automatic dubbing"
      +}
  10. Changed2 schema fields changed
    • changedInput schema / properties / saveAsDraft / description
      Previous value: -"Save as DRAFT instead of publishing or scheduling; publish later with publish_draft"New value: +"Save as DRAFT instead of publishing or scheduling; publish later with publish_draft. A scheduledAt sent with it is stored as the draft's planned date, and publish_draft schedules the draft for that date"
    • changedInput schema / properties / scheduledAt / description
      Previous value: -"Absolute ISO 8601 instant to schedule (e.g. \"2026-03-15T10:00:00Z\"). Omit to post immediately; a past time also posts immediately"New value: +"Absolute ISO 8601 instant to schedule (e.g. \"2026-03-15T10:00:00Z\"). Omit to post immediately; a past time also posts immediately. With saveAsDraft it is the draft's planned date instead: nothing is scheduled, and publish_draft without a date later schedules the draft for it"
  11. Changed1 schema field changed
    • changedInput schema / properties / tumblrConnectionIds / description
      Previous value: -"Tumblr blog account ids from list_accounts to post to"New value: +"Tumblr blogs to post to, by the account id from list_accounts. TUMBLR takes text up to 32768 characters, up to 30 JPEG, PNG or GIF images (10 MB each) or one MP4 video (500 MB, up to 10 minutes), and alt text; it has no first comments, threads, per-platform thumbnails, image shapes or analytics"
  12. Changed24 schema fields changed
    • addedInput schema / properties / accountIds
      Added value: +{
      +  "description": "Account ids (or Facebook pageIds) from list_accounts to post to. AdaptlyPost adds each account's platform to platforms and its id to the matching connection-id array, so you can send these instead of platforms and the per-platform arrays, or alongside them. An id not connected to the workspace fails with 400",
      +  "items": {
      +    "type": "string"
      +  },
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / contentType / description
      Previous value: -"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK and THREADS, 20 on LINKEDIN and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK, THREADS and TELEGRAM, 20 on LINKEDIN, 30 on TUMBLR and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"
    • changedInput schema / properties / facebookConfigs / description
      Previous value: -"Facebook per-page config: post type, shareToStory, video title and text background. pageId must match an entry in pageIds"New value: +"Facebook per-page config: post type, shareToStory, video title, text background, and a grid or link carousel for several images. pageId must match an entry in pageIds"
    • addedInput schema / properties / facebookConfigs / items / properties / carouselCards
      Added value: +{
      +  "description": "One card per image, in the same order as the media, used when imageLayout is CAROUSEL. Facebook only shows your image, title and description on a card whose link points to a website the Page owns; for any other link the post fails with the error Facebook returns",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "The line under the headline, such as a price or the domain. Without it Facebook uses the linked page",
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "link": {
      +        "description": "The http or https URL the card opens",
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      "title": {
      +        "description": "The card's headline. Without it Facebook uses the linked page's title",
      +        "maxLength": 100,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "link"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
    • addedInput schema / properties / facebookConfigs / items / properties / imageLayout
      Added value: +{
      +  "description": "How a post with several images shows on Facebook. GRID is a photo grid. CAROUSEL is a swipeable carousel where each image is a card with its own link, and needs 2 to 5 images, no videos, postType FEED and one carouselCards entry per image; anything else is refused with 400",
      +  "enum": [
      +    "GRID",
      +    "CAROUSEL"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / firstComments / description
      Previous value: -"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply) and YOUTUBE (10000). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"New value: +"A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply), YOUTUBE (10000), FACEBOOK (8000) and INSTAGRAM (2200). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a platform that also has threadReplies, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A Facebook Page or Instagram account connected before first comments came to them must be reconnected once; until then its comment fails and firstCommentError says to reconnect. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones"
    • changedInput schema / properties / firstComments / items / properties / platform / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "TWITTER",
      -  "THREADS",
      -  "BLUESKY",
      -  "MASTODON",
      -  "YOUTUBE"
      -]New value: +[
      +  "LINKEDIN",
      +  "TWITTER",
      +  "THREADS",
      +  "BLUESKY",
      +  "MASTODON",
      +  "YOUTUBE",
      +  "FACEBOOK",
      +  "INSTAGRAM"
      +]
    • changedInput schema / properties / instagramConfigs / description
      Previous value: -"Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, Reel audio, and trial reels"New value: +"Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, user tags, the AI info label, Reel audio, and trial reels"
    • addedInput schema / properties / instagramConfigs / items / properties / aiGenerated
      Added value: +{
      +  "description": "Disclose that the post was made or edited with AI. Instagram shows its \"AI info\" label on the post. Works on images, carousels, reels and stories, and a story made with shareToStory carries the label too. Omit it or send false for no label",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / instagramConfigs / items / properties / userTags
      Added value: +{
      +  "description": "Public Instagram accounts tagged in the media, up to 20. Works on a single image, a single video (published as a Reel) or a single story; a carousel or several stories with tags is refused with 400. On a feed image every tag needs x and y; on a story they are optional, and on a video they are ignored because the person is tagged on the video as a whole. A leading @ is stripped and a repeated username keeps its first entry. If Instagram refuses a tag because the account is private or does not exist, the post goes out without its tags and instagramUntaggedUsernames in get_post lists the refused usernames",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "username": {
      +        "description": "The public Instagram username to tag",
      +        "pattern": "^@?[A-Za-z0-9._]{1,30}$",
      +        "type": "string"
      +      },
      +      "x": {
      +        "description": "Horizontal position of the tag on the image, from 0 (left edge) to 1 (right edge)",
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "y": {
      +        "description": "Vertical position of the tag on the image, from 0 (top edge) to 1 (bottom edge)",
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "username"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • changedInput schema / properties / linkedinConfigs / description
      Previous value: -"LinkedIn per-connection config: documentTitle names a DOCUMENT post. connectionId must match an entry in linkedinConnectionIds"New value: +"LinkedIn per-connection config: documentTitle names a DOCUMENT post, reshareOf reshares another LinkedIn post with the text as commentary. connectionId must match an entry in linkedinConnectionIds"
    • addedInput schema / properties / linkedinConfigs / items / properties / reshareOf
      Added value: +{
      +  "description": "Reshare this LinkedIn post from the account, with the post text as the commentary. Takes a urn:li:share: or urn:li:ugcPost: URN, such as the platformPostId from list_post_results, or a LinkedIn post link of the form https://www.linkedin.com/feed/update/<urn>, which is also the link inside a post's Embed code. urn:li:activity: links are refused because LinkedIn cannot reshare them through its API. Media on the post is not attached on this account",
      +  "maxLength": 500,
      +  "type": "string"
      +}
    • changedInput schema / 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, Mastodon, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile 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, Tumblr, LinkedIn, Facebook, Instagram and Threads; Pinterest uses the first one (cut to 500). TikTok, YouTube, Google Business Profile and videos ignore it"
    • changedInput schema / properties / platformThumbnails / description
      Previous value: -"A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK and LINKEDIN take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones"New value: +"A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK, LINKEDIN and TELEGRAM take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones"
    • changedInput schema / properties / platformThumbnails / items / properties / platform / enum
      Previous value: -[
      -  "YOUTUBE",
      -  "FACEBOOK",
      -  "LINKEDIN",
      -  "INSTAGRAM",
      -  "PINTEREST",
      -  "TIKTOK"
      -]New value: +[
      +  "YOUTUBE",
      +  "FACEBOOK",
      +  "LINKEDIN",
      +  "TELEGRAM",
      +  "INSTAGRAM",
      +  "PINTEREST",
      +  "TIKTOK"
      +]
    • changedInput schema / properties / platforms / description
      Previous value: -"Target platforms (e.g. [\"LINKEDIN\", \"TWITTER\"]). Each one needs its matching connection-id array (pageIds for FACEBOOK, googleBusinessConnectionIds for GOOGLE_BUSINESS) filled with ids from list_accounts"New value: +"Target platforms (e.g. [\"LINKEDIN\", \"TWITTER\"]). Each one needs its matching connection-id array (pageIds for FACEBOOK, googleBusinessConnectionIds for GOOGLE_BUSINESS) filled with ids from list_accounts. Optional when accountIds is sent"
    • changedInput schema / properties / platforms / items / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "YOUTUBE",
      -  "INSTAGRAM",
      -  "FACEBOOK",
      -  "TIKTOK",
      -  "PINTEREST",
      -  "THREADS",
      -  "BLUESKY",
      -  "TWITTER",
      -  "MASTODON",
      -  "GOOGLE_BUSINESS"
      -]New value: +[
      +  "LINKEDIN",
      +  "YOUTUBE",
      +  "INSTAGRAM",
      +  "FACEBOOK",
      +  "TIKTOK",
      +  "PINTEREST",
      +  "THREADS",
      +  "BLUESKY",
      +  "TWITTER",
      +  "MASTODON",
      +  "GOOGLE_BUSINESS",
      +  "TUMBLR",
      +  "TELEGRAM"
      +]
    • addedInput schema / properties / platforms / minItems
      Added value: +1
    • addedInput schema / properties / telegramConnectionIds
      Added value: +{
      +  "description": "Telegram channels and groups to post to, by the account id from list_accounts. TELEGRAM takes text up to 4096 characters, up to 10 images (JPEG, PNG or WebP, 10 MB each) or one MP4 or MOV video (50 MB); a caption over 1024 characters goes out as its own message after the media",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / threadReplies
      Added value: +{
      +  "description": "Turns the post into a thread: the post opens it and each text is published as a reply to the one before, from the same account, one entry per platform. Available on TWITTER (280 characters per reply, or the account's own limit on X Premium), THREADS (500), BLUESKY (300) and MASTODON (500, or the instance's limit), up to 25 replies. A platform the post does not go to, an empty or too long reply, more than 25 replies, a second entry for one platform and a platform that also has a first comment are refused with 400. An entry with an empty texts array removes the thread. Replies start about 10 seconds after the platform publishes, 2 seconds apart. A failed run is retried up to 3 times and resumes after the last reply that went out; on X it is not retried, and a lifetime-deal account pays for each reply like any X post. A thread that fails never fails the post: read threadStatus, threadReplyIds and threadError on the platform in get_post. On an update, sending the array replaces every thread and omitting it keeps the stored ones",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "platform": {
      +        "enum": [
      +          "TWITTER",
      +          "THREADS",
      +          "BLUESKY",
      +          "MASTODON"
      +        ],
      +        "type": "string"
      +      },
      +      "texts": {
      +        "description": "The replies in order, each trimmed. The limit per reply depends on the platform, see threadReplies",
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 25,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "platform",
      +      "texts"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / tumblrConfigs
      Added value: +{
      +  "description": "Tumblr per-blog config: tags, a title and a source link. connectionId must match an entry in tumblrConnectionIds",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "connectionId": {
      +        "description": "Tumblr blog account id from list_accounts",
      +        "type": "string"
      +      },
      +      "sourceUrl": {
      +        "description": "Shown as the source link of the post",
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      "tags": {
      +        "description": "Tumblr tags, without commas, up to 30. A leading # is stripped and duplicates are dropped, ignoring case",
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 30,
      +        "type": "array"
      +      },
      +      "title": {
      +        "description": "Shown as a heading above the media and the text",
      +        "maxLength": 4096,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "connectionId"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / tumblrConnectionIds
      Added value: +{
      +  "description": "Tumblr blog account ids from list_accounts to post to",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / youtubeConfigs / items / properties / aiGenerated
      Added value: +{
      +  "description": "Disclose altered or synthetic content, such as an AI voice, an AI avatar or realistic footage that was generated or edited. YouTube shows its \"Altered or synthetic content\" label on the video. Omit it or send false for no label",
      +  "type": "boolean"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "platforms",
      -  "contentType"
      -]New value: +[
      +  "contentType"
      +]
  13. Changed2 schema fields changed
    • changedInput schema / properties / recurrence / description
      Previous value: -"Repeat the post on a schedule. Needs a future scheduledAt, which becomes the first post and sets the time of day in timezone. Cannot be combined with saveAsDraft or TIKTOK. Missed slots, for example while paused, are skipped and never published late. X and LinkedIn reject identical text, so use spintax such as {Hi|Hello} to vary each post. Manage the series with list_recurring_posts, pause_recurring_post, resume_recurring_post and delete_recurring_post"New value: +"Repeat the post on a schedule the user asked for, and confirm that schedule with them first. Needs a future scheduledAt, which becomes the first post and sets the time of day in timezone. Cannot be combined with saveAsDraft or TIKTOK. Missed slots, for example while paused, are skipped and never published late. The user can pause or stop the series at any time with pause_recurring_post or delete_recurring_post; list_recurring_posts shows it"
    • changedInput schema / properties / recurrence / properties / maxOccurrences / description
      Previous value: -"Total number of posts the series publishes, 2 to 365. Cannot be combined with endsOn; omit both to repeat until paused or deleted"New value: +"Total number of posts the series publishes, 2 to 365. Cannot be combined with endsOn; omit both to repeat until the user pauses or deletes the series"
  14. Changed3 schema fields changed
    • changedInput schema / properties / pinterestConfigs / description
      Previous value: -"Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId; a board belongs to one Pinterest account. Without boardId the pin goes to a board named AdaptlyPost"New value: +"Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId, or pass the board name as boardName instead (not both); a board belongs to one Pinterest account. A boardName that matches no board or several fails with 400. Without either the pin goes to a board named AdaptlyPost"
    • changedInput schema / properties / pinterestConfigs / items / properties / boardId / description
      Previous value: -"Board id from list_pinterest_boards. Leave out to pin to a public board named AdaptlyPost, created on the account the first time it is needed"New value: +"Board id from list_pinterest_boards. Leave out boardId and boardName to pin to a public board named AdaptlyPost, created on the account the first time it is needed"
    • addedInput schema / properties / pinterestConfigs / items / properties / boardName
      Added value: +{
      +  "description": "The board's name, instead of boardId; never send both. Matched against this account's boards, exact first, then case-insensitive. A name no board has, or one several boards share, fails with 400 and never falls back to another board",
      +  "maxLength": 180,
      +  "minLength": 1,
      +  "type": "string"
      +}
  15. Changed3 schema fields changed
    • changedInput schema / properties / pinterestConfigs / description
      Previous 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"New value: +"Pinterest per-connection config: the board to pin to, a pin title and a destination link. Get boardId from list_pinterest_boards for that connectionId; a board belongs to one Pinterest account. Without boardId the pin goes to a board named AdaptlyPost"
    • changedInput schema / properties / pinterestConfigs / items / properties / boardId / description
      Previous value: -"Pinterest board ID to pin to (required)"New value: +"Board id from list_pinterest_boards. Leave out to pin to a public board named AdaptlyPost, created on the account the first time it is needed"
    • changedInput schema / properties / pinterestConfigs / items / required
      Previous value: -[
      -  "connectionId",
      -  "boardId"
      -]New value: +[
      +  "connectionId"
      +]
  16. Changed26 schema fields changed
    • changedInput schema / properties / contentType / description
      Previous value: -"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls (CAROUSEL needs several). DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"New value: +"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls. CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK and THREADS, 20 on LINKEDIN and 35 on TIKTOK (JPEG or WebP photos only). INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"
    • changedInput schema / properties / facebookConfigs / description
      Previous value: -"Facebook per-page config with post type and video title. pageId must match an entry in pageIds"New value: +"Facebook per-page config: post type, shareToStory, video title and text background. pageId must match an entry in pageIds"
    • changedInput schema / properties / facebookConfigs / items / properties / postType / description
      Previous value: -"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"New value: +"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE, VIDEO or CAROUSEL (a CAROUSEL story publishes each media item as its own story, in order). Any other combination is refused with 400"
    • addedInput schema / properties / facebookConfigs / items / properties / shareToStory
      Added value: +{
      +  "description": "Also publish the same media as a story on this page, next to the FEED or REEL post. The story shows as its own entry in platforms with postType STORY, so it succeeds, fails and retries on its own. It skips the caption, video title and text background, needs IMAGE, VIDEO or CAROUSEL, and a video must fit the story length limit (60 seconds). Ignored when postType is STORY",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / facebookConfigs / items / properties / textFormatPresetId
      Added value: +{
      +  "description": "Facebook's id for a colored text background (for example 106018623298955 is solid purple, 249307305544279 is a red to blue gradient). Only for contentType TEXT posts with no media and text up to 130 characters; anything else is refused with 400. Links in the text show without a preview. If Facebook refuses the background, the post goes out as plain text",
      +  "pattern": "^\\d{1,20}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / firstComments
      Added value: +{
      +  "description": "A comment posted from the same account right after the post goes out on a platform, one entry per platform. Available on LINKEDIN (1250 characters), TWITTER (280, as a reply), THREADS (500, as a reply), BLUESKY (300, as a reply), MASTODON (500, as a reply) and YOUTUBE (10000). A platform the post does not go to, an empty or too long comment, a second entry for one platform, a private or made for kids YouTube video and Facebook or Instagram stories are refused with 400. The comment is posted about 10 seconds after the platform publishes (60 on YouTube) and retried up to 3 times; on X it is not retried, and a lifetime-deal account pays for it like any X post. A comment that fails never fails the post: read firstCommentStatus and firstCommentError on the platform in get_post. On an update, sending the array replaces every first comment and omitting it keeps the stored ones",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "platform": {
      +        "enum": [
      +          "LINKEDIN",
      +          "TWITTER",
      +          "THREADS",
      +          "BLUESKY",
      +          "MASTODON",
      +          "YOUTUBE"
      +        ],
      +        "type": "string"
      +      },
      +      "text": {
      +        "description": "The comment's text, trimmed. The limit depends on the platform, see firstComments",
      +        "maxLength": 10000,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "platform",
      +      "text"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / googleBusinessConfigs
      Added value: +{
      +  "description": "Google Business Profile per-location config: update, event or offer, plus a button. connectionId must match an entry in googleBusinessConnectionIds. GOOGLE_BUSINESS takes TEXT or IMAGE with one JPEG or PNG image up to 5 MB, and text up to 1500 characters",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "callToActionType": {
      +        "description": "Button shown on the post. Every type except CALL needs callToActionUrl; CALL dials the phone number on the Business Profile",
      +        "enum": [
      +          "BOOK",
      +          "ORDER",
      +          "SHOP",
      +          "LEARN_MORE",
      +          "SIGN_UP",
      +          "CALL"
      +        ],
      +        "type": "string"
      +      },
      +      "callToActionUrl": {
      +        "description": "Ignored when callToActionType is CALL",
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "connectionId": {
      +        "description": "Google Business Profile account id from list_accounts",
      +        "type": "string"
      +      },
      +      "eventEnd": {
      +        "$ref": "#/properties/googleBusinessConfigs/items/properties/eventStart",
      +        "description": "YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T21:00\")"
      +      },
      +      "eventStart": {
      +        "description": "YYYY-MM-DD or YYYY-MM-DDTHH:mm in the business's local time, with no offset (e.g. \"2026-10-01T18:00\"). Google reads event times in the location's time zone",
      +        "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2})?$",
      +        "type": "string"
      +      },
      +      "eventTitle": {
      +        "description": "Title of the event or offer",
      +        "type": "string"
      +      },
      +      "offerCouponCode": {
      +        "description": "OFFER only: coupon code",
      +        "type": "string"
      +      },
      +      "offerRedeemUrl": {
      +        "description": "OFFER only: where the offer is redeemed",
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "offerTerms": {
      +        "description": "OFFER only: terms and conditions",
      +        "type": "string"
      +      },
      +      "topicType": {
      +        "description": "STANDARD is an update. EVENT and OFFER need eventTitle, eventStart and eventEnd",
      +        "enum": [
      +          "STANDARD",
      +          "EVENT",
      +          "OFFER"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "connectionId",
      +      "topicType"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / googleBusinessConnectionIds
      Added value: +{
      +  "description": "Google Business Profile locations to post to, by the account id from list_accounts. A location without an entry in googleBusinessConfigs gets a STANDARD update",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / instagramConfigs / description
      Previous value: -"Instagram per-connection config to set post type (FEED, REEL, STORY) and publish a reel as a trial reel"New value: +"Instagram per-connection config: post type (FEED, REEL, STORY), shareToStory, collaborators, Reel audio, and trial reels"
    • addedInput schema / properties / instagramConfigs / items / properties / audio
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Music or an original sound from Instagram's audio library, added to the Reel when it is published. Needs contentType VIDEO and a postType other than STORY, and only works for accounts with supportsInstagramAudio: true in list_accounts (connected through Facebook). Find ids with search_instagram_audio",
      +  "properties": {
      +    "artist": {
      +      "description": "Artist or creator, stored for display only",
      +      "maxLength": 255,
      +      "type": "string"
      +    },
      +    "audioId": {
      +      "description": "audioId from search_instagram_audio",
      +      "maxLength": 64,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "audioVolume": {
      +      "description": "Volume of the added audio, 1 to 100. Defaults to 100",
      +      "maximum": 100,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    "title": {
      +      "description": "Track title, stored for display only",
      +      "maxLength": 255,
      +      "type": "string"
      +    },
      +    "videoVolume": {
      +      "description": "Volume of the video's own sound, 1 to 100. Defaults to 100",
      +      "maximum": 100,
      +      "minimum": 1,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "audioId"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / instagramConfigs / items / properties / collaborators
      Added value: +{
      +  "description": "Instagram usernames invited as collaborators (Instagram Collab), up to 3. A leading @ is stripped and duplicates are dropped. Works on feed images, carousels and reels; a story or a trial reel with collaborators is refused with 400. Each collaborator gets an invite in Instagram and must accept it before the post shows on their profile",
      +  "items": {
      +    "pattern": "^@?[A-Za-z0-9._]{1,30}$",
      +    "type": "string"
      +  },
      +  "maxItems": 3,
      +  "type": "array"
      +}
    • changedInput schema / properties / instagramConfigs / items / properties / postType / description
      Previous value: -"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"New value: +"Where the post goes: FEED works with every content type, REEL needs contentType VIDEO, STORY needs IMAGE, VIDEO or CAROUSEL (a CAROUSEL story publishes each media item as its own story, in order). Any other combination is refused with 400"
    • addedInput schema / properties / instagramConfigs / items / properties / shareToStory
      Added value: +{
      +  "description": "Also publish the same media as a story on this account, next to the FEED or REEL post. The story shows as its own entry in platforms with postType STORY, so it succeeds, fails and retries on its own. It skips the caption, first comment, cover, collaborators, trial and audio, needs IMAGE, VIDEO or CAROUSEL, and a video must fit the story length limit (60 seconds). Ignored when postType is STORY",
      +  "type": "boolean"
      +}
    • changedInput schema / 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, Mastodon, 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, Google Business Profile and videos ignore it"
    • addedInput schema / properties / platformAspectRatios
      Added value: +{
      +  "description": "Reframe every image of an IMAGE or CAROUSEL post to one shape on a platform, one entry per platform. INSTAGRAM takes SQUARE, PORTRAIT or LANDSCAPE (Instagram refuses 9:16 feed and carousel images); TIKTOK takes all four. Video posts, Instagram stories and a second entry for the same platform are refused with 400. Omit a platform to keep its images as uploaded. On an update it applies to the mediaUrls sent in the same request",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "aspectRatio": {
      +        "description": "SQUARE is 1:1, PORTRAIT 4:5, VERTICAL 9:16 and LANDSCAPE 1.91:1",
      +        "enum": [
      +          "SQUARE",
      +          "PORTRAIT",
      +          "VERTICAL",
      +          "LANDSCAPE"
      +        ],
      +        "type": "string"
      +      },
      +      "fit": {
      +        "description": "How an image of another shape reaches the ratio. CROP (the default) cuts it from the center; PAD keeps the whole image and fills the rest with a blurred copy of it",
      +        "enum": [
      +          "CROP",
      +          "PAD"
      +        ],
      +        "type": "string"
      +      },
      +      "platform": {
      +        "enum": [
      +          "INSTAGRAM",
      +          "TIKTOK"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "platform",
      +      "aspectRatio"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / platformTexts / items / properties / text / description
      Added value: +"On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it"
    • addedInput schema / properties / platformThumbnails
      Added value: +{
      +  "description": "A different thumbnail for one platform of a VIDEO post, one entry per platform. A platform without an entry uses the post-level thumbnailUrl and thumbnailTimestampMs. YOUTUBE, FACEBOOK and LINKEDIN take an image (thumbnailUrl); INSTAGRAM and PINTEREST take an image or a frame (thumbnailTimestampMs), the image winning when both are sent; TIKTOK takes only a frame. Posts that are not videos, Facebook and Instagram stories, a second entry for one platform and an entry the platform cannot use are refused with 400. On an update, sending the array replaces every override and omitting it keeps the stored ones",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "platform": {
      +        "enum": [
      +          "YOUTUBE",
      +          "FACEBOOK",
      +          "LINKEDIN",
      +          "INSTAGRAM",
      +          "PINTEREST",
      +          "TIKTOK"
      +        ],
      +        "type": "string"
      +      },
      +      "thumbnailTimestampMs": {
      +        "description": "The video frame (ms from the start) to use as this platform's thumbnail",
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "thumbnailUrl": {
      +        "description": "The image to use as this platform's thumbnail, an https URL or an image data URI",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "platform"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / platforms / description
      Previous value: -"Target platforms (e.g. [\"LINKEDIN\", \"TWITTER\"]). Each one needs its matching connection-id array (pageIds for FACEBOOK) filled with ids from list_accounts"New value: +"Target platforms (e.g. [\"LINKEDIN\", \"TWITTER\"]). Each one needs its matching connection-id array (pageIds for FACEBOOK, googleBusinessConnectionIds for GOOGLE_BUSINESS) filled with ids from list_accounts"
    • changedInput schema / properties / platforms / items / enum
      Previous value: -[
      -  "LINKEDIN",
      -  "YOUTUBE",
      -  "INSTAGRAM",
      -  "FACEBOOK",
      -  "TIKTOK",
      -  "PINTEREST",
      -  "THREADS",
      -  "BLUESKY",
      -  "TWITTER",
      -  "MASTODON"
      -]New value: +[
      +  "LINKEDIN",
      +  "YOUTUBE",
      +  "INSTAGRAM",
      +  "FACEBOOK",
      +  "TIKTOK",
      +  "PINTEREST",
      +  "THREADS",
      +  "BLUESKY",
      +  "TWITTER",
      +  "MASTODON",
      +  "GOOGLE_BUSINESS"
      +]
    • changedInput schema / properties / recurrence / properties / frequency / description
      Previous value: -"How often the post repeats: DAILY, WEEKLY, or MONTHLY"New value: +"How often the post repeats: DAILY, WEEKLY, MONTHLY or YEARLY. YEARLY repeats on the same date; a series started on February 29 posts on February 28 in other years"
    • changedInput schema / properties / recurrence / properties / frequency / enum
      Previous value: -[
      -  "DAILY",
      -  "WEEKLY",
      -  "MONTHLY"
      -]New value: +[
      +  "DAILY",
      +  "WEEKLY",
      +  "MONTHLY",
      +  "YEARLY"
      +]
    • changedInput schema / properties / recurrence / properties / interval / description
      Previous value: -"Repeat every N days, weeks or months, 1 to 30 (default 1)"New value: +"Repeat every N days, weeks, months or years, 1 to 30 (default 1)"
    • changedInput schema / properties / text / description
      Previous value: -"Default post text shared across platforms"New value: +"Default post text shared across platforms. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it"
    • changedInput schema / properties / thumbnailTimestampMs / description
      Previous value: -"Generate thumbnail from video at this timestamp (milliseconds)"New value: +"Video frame timestamp (ms) to use as the thumbnail, used by INSTAGRAM, PINTEREST and TIKTOK unless platformThumbnails overrides it"
    • changedInput schema / properties / thumbnailUrl / description
      Previous value: -"Custom thumbnail image URL for video posts"New value: +"Video thumbnail as an https URL or an image data URI, used on every platform that takes one unless platformThumbnails overrides it"
    • addedInput schema / properties / twitterKeepLinks
      Added value: +{
      +  "description": "Keep links in the X text clickable. X charges over 10 times more for a post with a link, so by default every link in X text is broken (example.com becomes example. com). Only AppSumo lifetime deals can turn this on, and a kept link costs 20 credits instead of 2. true on any other plan is refused with 400; it is ignored when the X text has no link",
      +  "type": "boolean"
      +}
  17. Changed2 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedOutput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
  18. Changed4 schema fields changed
    • changedInput schema / properties / facebookConfigs / items / properties / postType / description
      Previous value: -"Facebook post type — FEED, REEL, or STORY"New value: +"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"
    • changedInput schema / properties / instagramConfigs / items / properties / postType / description
      Previous value: -"Instagram post type — FEED, REEL, or STORY"New value: +"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"
    • addedInput schema / properties / recurrence / properties / weekdays / maxItems
      Added value: +7
    • 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"
  19. Changed1 schema field changed
    • 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"
      +}
  20. Changed2 schema fields changed
    • 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"
      +}
  21. Changed2 schema fields changed
    • addedInput schema / properties / recurrence
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Repeat the post on a schedule. Needs a future scheduledAt, which becomes the first post and sets the time of day in timezone. Cannot be combined with saveAsDraft or TIKTOK. Missed slots, for example while paused, are skipped and never published late. X and LinkedIn reject identical text, so use spintax such as {Hi|Hello} to vary each post. Manage the series with list_recurring_posts, pause_recurring_post, resume_recurring_post and delete_recurring_post",
      +  "properties": {
      +    "endsOn": {
      +      "description": "Last day an occurrence may go out on, as YYYY-MM-DD (inclusive). Must be on or after the day of the first post. Cannot be combined with maxOccurrences",
      +      "type": "string"
      +    },
      +    "frequency": {
      +      "description": "How often the post repeats: DAILY, WEEKLY, or MONTHLY",
      +      "enum": [
      +        "DAILY",
      +        "WEEKLY",
      +        "MONTHLY"
      +      ],
      +      "type": "string"
      +    },
      +    "interval": {
      +      "description": "Repeat every N days, weeks or months, 1 to 30 (default 1)",
      +      "maximum": 30,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    "maxOccurrences": {
      +      "description": "Total number of posts the series publishes, 2 to 365. Cannot be combined with endsOn; omit both to repeat until paused or deleted",
      +      "maximum": 365,
      +      "minimum": 2,
      +      "type": "integer"
      +    },
      +    "weekdays": {
      +      "description": "WEEKLY only: the weekdays it goes out on (e.g. [\"MONDAY\", \"THURSDAY\"]). The weekday of scheduledAt is always included",
      +      "items": {
      +        "enum": [
      +          "MONDAY",
      +          "TUESDAY",
      +          "WEDNESDAY",
      +          "THURSDAY",
      +          "FRIDAY",
      +          "SATURDAY",
      +          "SUNDAY"
      +        ],
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "frequency"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / result / description
      Previous value: -"An object with postId, queuedPlatforms (platforms whose publishing job was queued; empty for scheduled posts and drafts), skippedPlatforms, isScheduled, and scheduledAt. Publishing is asynchronous: check list_post_results for outcomes."New value: +"An object with postId, queuedPlatforms (platforms whose publishing job was queued; empty for scheduled posts and drafts), skippedPlatforms, isScheduled, and scheduledAt, plus recurringPostId when recurrence was sent. Publishing is asynchronous: check list_post_results for outcomes."
  22. Changed3 schema fields changed
    • changedInput schema / properties / contentType / description
      Previous value: -"Content type: TEXT, IMAGE, VIDEO, or CAROUSEL. Must match mediaUrls (CAROUSEL needs several)"New value: +"Content type: TEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. Must match mediaUrls (CAROUSEL needs several). DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post and is LinkedIn only: put exactly that one file in mediaUrls, target only LINKEDIN, and set the title with linkedinConfigs"
    • changedInput schema / properties / contentType / enum
      Previous value: -[
      -  "TEXT",
      -  "IMAGE",
      -  "VIDEO",
      -  "CAROUSEL"
      -]New value: +[
      +  "TEXT",
      +  "IMAGE",
      +  "VIDEO",
      +  "CAROUSEL",
      +  "DOCUMENT"
      +]
    • addedInput schema / properties / linkedinConfigs
      Added value: +{
      +  "description": "LinkedIn per-connection config: documentTitle names a DOCUMENT post. connectionId must match an entry in linkedinConnectionIds",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "connectionId": {
      +        "description": "LinkedIn connection ID from list_accounts",
      +        "type": "string"
      +      },
      +      "documentTitle": {
      +        "description": "Title LinkedIn shows on a DOCUMENT post (max 100 chars). Defaults to the file name; ignored for other content types",
      +        "maxLength": 100,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "connectionId"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  23. Changed1 schema field changed
    • changedInput schema / properties / mediaUrls / description
      Previous value: -"Media URLs to attach. Use publicUrl values from upload_media or get_upload_urls"New value: +"Media URLs to attach. Use publicUrl values from upload_media or get_upload_urls; the same publicUrl may be reused across posts. Do not reuse mediaUrls read back from a published post, which may be expiring platform links"
  24. Changed3 schema fields changed
    • addedInput schema / properties / mastodonConnectionIds
      Added value: +{
      +  "description": "Mastodon account connection IDs to post from",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / 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"
    • 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"
      +]
  25. Changed1 schema field changed
    • addedInput schema / 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"
      +}
  26. Changed9 schema fields changed
    • changedInput schema / properties / contentType / description
      Previous value: -"Content type: TEXT, IMAGE, VIDEO, or CAROUSEL"New value: +"Content type: TEXT, IMAGE, VIDEO, or CAROUSEL. Must match mediaUrls (CAROUSEL needs several)"
    • 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 (e.g. [\"LINKEDIN\", \"TWITTER\"])"New value: +"Target platforms (e.g. [\"LINKEDIN\", \"TWITTER\"]). Each one needs its matching connection-id array (pageIds for FACEBOOK) filled with ids from list_accounts"
    • changedInput schema / properties / saveAsDraft / description
      Previous value: -"Save as draft instead of publishing"New value: +"Save as DRAFT instead of publishing or scheduling; publish later with publish_draft"
    • changedInput schema / properties / scheduledAt / description
      Previous value: -"ISO 8601 datetime to schedule (e.g. \"2026-03-15T10:00:00Z\"). Omit to post immediately"New value: +"Absolute ISO 8601 instant to schedule (e.g. \"2026-03-15T10:00:00Z\"). Omit to post immediately; a past time also posts immediately"
    • changedInput schema / properties / timezone / description
      Previous value: -"IANA timezone (e.g. \"America/New_York\")"New value: +"IANA timezone stored with the post for display (e.g. \"America/New_York\"); it does not shift scheduledAt"
    • changedOutput schema / properties / result / description
      Previous value: -"The created post record including its id, status, and scheduled time as returned by the AdaptlyPost API."New value: +"An object with postId, queuedPlatforms (platforms whose publishing job was queued; empty for scheduled posts and drafts), skippedPlatforms, isScheduled, and scheduledAt. Publishing is asynchronous: check list_post_results for outcomes."
  27. First observed

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already state destructiveHint=true and idempotentHint=false, but the description adds the crucial operational context: publishing runs per platform in the background, so the returned { postId, queuedPlatforms, isScheduled, scheduledAt } is not the outcome and you must read list_post_results. It also warns that each call makes a separate post, which explains the non-idempotent behavior concretely. It does not detail failure/retry semantics per platform, keeping it below a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action and mode logic (draft vs schedule vs publish-now vs recurrence) before the supporting details. It is a single dense paragraph, and the parenthetical catalogue of platform-specific options is longer than it needs to be since the fields already document themselves.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 44-parameter, deeply nested, destructive, open-world creation tool, this covers the full lifecycle: input sources, readiness validation, confirmation, background execution, result retrieval, duplicate risk, and handoff to sibling tools. An output schema exists, so it correctly does not describe return values beyond warning that they are not the outcome.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, but the description adds cross-parameter meaning the schema does not: accountIds and platforms are interchangeable inputs sourced from list_accounts, mediaUrls come from upload_media, and saveAsDraft plus scheduledAt together mean a planned draft date rather than a schedule. The long enumeration of platform-specific options only points at field descriptions rather than adding new meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource plus scope: "Create one post on the user's own connected social accounts." It explicitly separates itself from update_post, publish_draft, bulk_schedule_posts and validate_post, so an agent can route without opening another schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use rules: call validate_post first to catch every problem, use update_post or publish_draft for an existing post, bulk_schedule_posts for many, and confirm final text/media/accounts/time with the user before publishing or scheduling (drafts excepted). It also forbids blind retries after an error or timeout without checking list_posts first.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources