Skip to main content
Glama
Hermoso

Hermoso

Official

Schedule a post for later

schedule_post
Destructive

Schedule a social media post for a future time or the next free queue slot across one or more channels, with per-channel captions, media, and account targeting.

Instructions

Use this to schedule a social media post for later, on one channel or several. Costs no credits (X alone bills per call: hermoso_credits). FREE PLAN: 5 posts a month on up to 3 channels (a post counts once; UTC month); paid plans are unlimited. Over it the post is refused and nothing is queued: relay the refusal as written, never retry or split the post. A MULTI-SLIDE creative goes in imageUrls[] as a CAROUSEL, in order, never just slide 1. Name the time in at, or pass useQueue:true for the brand’s next free POSTING SLOT (“just queue it”). Hermoso never guesses the account: Pinterest needs boardId (list_pinterest_boards), else refused; a LinkedIn COMPANY PAGE post needs linkedinOrganizationId (list_linkedin_pages), else it goes to the person’s own profile. Several Facebook Pages need pageId (list_meta_pages), for Facebook and for an Instagram that posts through a Page: none named is refused at scheduling with the Pages listed, so ask the user which. Resolve these FIRST; let the user pick. Posts GO LIVE PUBLICLY by default. Full rules: get_instructions({topic:'schedule_post'}).

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": {
      "channels": "<channels>"
    },
    "name": "schedule_post"
  }
}

Input Schema

NameRequiredDescriptionDefault
atNowhen to post: local wall clock, no offset (2026-10-30T10:00), read in `timezone` or the brand’s zone ON THAT DATE so a series survives a clock change; or UTC (…Z) / epoch ms. Future, at most 365 days out. Give this OR useQueue, never both.
hookNoWHAT ANGLE this post is built on, recorded only at publish time. post_performance ranks hooks on it (a winner needs 5 posts sharing ONE hook), so pass a list_hooks id (e.g. "direct_callout", "before_after") or reuse your own wording EXACTLY across a campaign. Omit it and this post never votes on which hook works.
linkNoa link to attach (Facebook)
pollNoX — attach a poll: {options:["…","…"], durationMinutes}. 2–4 options of at most 25 characters each; voting runs 5–10080 minutes (7 days), default 1440. X makes a poll MUTUALLY EXCLUSIVE with media, so an item carrying an image or video is refused — schedule the poll as its own X-only post.
tagsNoYOUTUBE — up to 30 search tags for the video (plain words, no #).
brandNoWHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no profile, or two, is REFUSED and nothing is posted.
eventNoGOOGLE BUSINESS — required for an EVENT or OFFER post: {title, startDate:"YYYY-MM-DD", endDate, startTime:"HH:MM", endTime}. `title` is the EVENT’s headline, a different thing from the post `title` (which is the Pinterest/YouTube one). Google documents its TimeInterval as needing all four date/time parts to be valid, so send the times whenever you know them.
offerNoGOOGLE BUSINESS — OFFER posts only: {couponCode, redeemOnlineUrl, termsConditions}. redeemOnlineUrl is where an offer actually sends people, since the button link is ignored on an Offer.
placeNoFACEBOOK — tag a location on the Page post. The pageId from search_meta_places: the NUMERIC ID OF THE FACEBOOK PAGE for that place, not a place name and not coordinates.
storyNoINSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. Link stickers are not available on a Story posted here. An Instagram Story keeps its caption: people see the start under the Story in the mobile app and tap for the rest. It takes NO collaborators, product tags or trialReel — any of those is refused by name and nothing is posted. FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page.
titleNoPINTEREST / YOUTUBE — the headline, max 100 characters. Pinterest shows it in search and under the pin; YouTube requires one. Leave it out and Hermoso derives one from that channel’s caption (first sentence, cut on a word boundary, trailing hashtags dropped) — set a real one whenever the caption does not open with a usable headline.
chatIdNoTELEGRAM — REQUIRED whenever telegram is a channel: WHICH chat, group or channel the bot posts to. A public channel’s @username (@yourchannel) or the numeric id (a group is negative; a supergroup or channel starts with -100). There is no default and there cannot be one — the Telegram Bot API publishes no method that lists a bot’s chats — so scheduling telegram without one is refused up front. list_telegram_chats finds ids for chats that have messaged the bot in the last 24 hours.
ideaIdNoshort id of the content-plan idea this post came from
pageIdNoFACEBOOK / INSTAGRAM / THREADS — which connected Facebook Page (and its linked Instagram) publishes, from list_meta_pages. Needed when the profile has more than one Page connected: a Facebook post with several and no id is refused WHEN YOU SCHEDULE IT, with the Pages listed by name and id, so ask the user which Page and schedule again with its id. It is never sent from a guessed Page.
recipeNothe post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format
silentNoTELEGRAM / DISCORD — no notification.
threadNoX — publish a THREAD, one entry per post, each replying to the one before (at most 25). 280 characters per part without X Premium, up to 25,000 with it; nothing is truncated. It REPLACES the X caption: with a thread set, `message`/`captions.x` is not sent to X at all. A thread cannot carry a poll.
wpSlugNoWORDPRESS — the post slug
wpTagsNoWORDPRESS — tags (names or ids)
altTextNoACCESSIBILITY — the screen-reader description of the attached image. ONE STRING describes the picture; on a CAROUSEL it describes EVERY slide. Pass an ARRAY of strings instead to describe each slide separately, aligned to the slide order — use that on a multi-slide post, because one sentence read out over six different pictures is wrong for five of them. More descriptions than pictures is refused rather than dropped. Write one whenever the post carries an image: describe what is IN the picture, never a repeat of the caption, which a screen reader already reads. CARRIED BY: X (max 1000, one per media), Pinterest (max 500 — PIN-LEVEL only, since its API has no per-item alt text, so slide 1’s description is used for the whole Pin and the result says the others were not sent), LinkedIn COMPANY PAGES (max 4086, one per slide), INSTAGRAM image posts and image slides (max 1000), FACEBOOK photos and albums, and BLUESKY, whose lexicon makes it REQUIRED on every image. The schedule is REFUSED if the LONGEST description exceeds the tightest of the channels on it, rather than truncated on the way out. NOT CARRIED, and none of these is a refusal — the post still publishes, just undescribed there, and the per-channel result says which: TikTok (its photo post has no alt field at any level), a THREADS CAROUSEL, an INSTAGRAM Reel or video slide, and a LinkedIn PERSONAL-profile post.
audioIdNoINSTAGRAM REEL — put one of Instagram’s OWN licensed music tracks under the Reel: the `id` search_instagram_audio returns. Instagram mixes it in when the Reel is published; nothing is downloaded or re-rendered. REELS ONLY, and only on an Instagram account connected through Meta (a Facebook Page with a linked Instagram), which is Instagram’s own rule — the Instagram connector cannot take it and is refused by name.
boardIdNoPINTEREST — REQUIRED whenever pinterest is a channel: the board the Pin goes on, from list_pinterest_boards. The user picks it; a Pin on the wrong board is a public mistake. Scheduling pinterest without one is refused immediately.
buttonsNoTELEGRAM ONLY — URL buttons under the post, as post_to_telegram takes them; never on an album.
excerptNoBLOG — the excerpt under the title
messageNothe caption/text used for every channel unless overridden in captions
subjectNoWHAT THIS POST IS ABOUT — product, feature, offer or theme (e.g. "winter coat", "free trial"). post_performance's second grouping axis: reuse the exact wording, as with hook.
accountsNoWHICH accounts of a multi-account channel to post to, e.g. { "tiktok": ["@a", "@b"] } or { "tiktok": "all" } — one row per account at fire time, each with its own result. Omit for channels with one account (several and none named is refused by name).
audienceNoFACEBOOK PAGE POST ONLY — limit who can see this organic post to people in these places and/or over this age (Facebook allows 13, 15, 18, 21 or 25). Not on Instagram, Threads or a Facebook Reel (a vertical clip becomes a Reel): those are refused. Region and city keys come from the Meta ads location search.
blogSlugNoblog post slug
blogTagsNoShopify blog / Wix tags
captionsNoper-channel caption overrides, e.g. { "instagram": "…", "threads": "…" } — platforms want different lengths and hashtag conventions
channelsYesone or more channels to post to at that time
coverUrlNoINSTAGRAM REEL COVER — a public image url Instagram fetches and uses as the cover in the Reels tab. REELS ONLY, and the alternative to `thumbOffset`: passing both is refused, since they are two answers to the same question. Run a local file through upload_file first.
imageUrlNoa Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL. NOTE: only Facebook/Instagram/Threads accept an arbitrary public URL — X, TikTok, YouTube, LinkedIn, Pinterest and Google Business re-host the bytes and REFUSE anything that is not a Hermoso render, so run an external file through upload_file first and schedule that url; a URL, not a local file path; use upload_file for local files
linkNameNoFACEBOOK — override the HEADLINE of the link preview. Without it the post shows whatever Open Graph title the destination carries, which on a bare landing page is often nothing. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager > Brand safety > Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain.
seoTitleNoblog search title
timezoneNoIANA zone (e.g. "Africa/Cairo") a wall-clock `at` or the queue is read in; overrides the brand’s saved zone for this one post. Without either, UTC.
topicTagNoTHREADS ONLY — one topic tag for the post, without the leading #.
useQueueNotake the next free slot in a posting queue (“just queue it”): true = default queue, or a queue name (manage_post_queues). Not with `at`; refused by name when no slot is free.
userTagsNoINSTAGRAM USER TAGS — tag people (public accounts) on the post; each is notified. Usernames, or { username, x, y } with x/y from 0 to 1 = where the tag sits on the IMAGE (a tag without a position sits at the centre). A Reel tag takes no position; a story position is optional. Not on a carousel (refused by name).
videoUrlNoa Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL — required for youtube, and for tiktok unless you pass an imageUrl (TikTok takes a photo post too). Same origin rule as imageUrl: everything except Facebook/Instagram/Threads REFUSES a non-Hermoso URL, so pass external video through upload_file first; a URL, not a local file path; use upload_file for local files
whopPollNoWHOP FORUM POSTS ONLY — a poll: 2 to 10 options, in order.
xArticleNoX: publish the X item as a long-form X ARTICLE. title is its headline, the X text (message or captions.x) its markdown body, the image its cover. Refused now if the markdown has formatting X cannot hold. X allows about 5 Articles a day; one that fires into that cap fails with the reset time and can be retried.
audioNameNoINSTAGRAM REEL — the name of the Reel’s audio track, which is what viewers tap through to. REELS ONLY.
coverAtMsNoTHE VIDEO COVER on EVERY channel of this post, as ONE frame: milliseconds from the start (7000 = the frame at 7s). Instagram, TikTok, Facebook, LinkedIn Page, Pinterest, Telegram and YouTube all get that frame; X, Threads and Bluesky have no cover setting. A channel’s own field (thumbOffset, coverTimestampMs, coverUrl) wins there and otherwise counts as this.
imageUrlsNoCAROUSEL — an ORDERED list of image URLs to publish as ONE swipeable post on every channel that supports it (Instagram 2–20, Threads 2–20, Facebook, LinkedIn company Pages 2–20, Pinterest 2–5, TikTok up to 35 as a photo post). Use this whenever the creative is a multi-slide deck: a scheduled post carrying only slide 1 of a “1/6 · SWIPE” set is a broken ad that nobody is watching when it fires. THE ORDER IS THE PRODUCT. A channel on this schedule that cannot do carousels — X, YouTube, Google Business Profile — is REFUSED NOW, with the reason, so you can drop it or give it its own single image; it is never quietly downgraded hours later.
parseModeNoTELEGRAM ONLY — 'HTML' for Telegram's HTML tags; omit for plain text.
placeNameNothe name the user saw for that place; a different business is refused
slideTextNoPINTEREST CAROUSEL ONLY — per-slide title / description / link, aligned to slide order. Every other platform takes ONE caption for the whole carousel.
topicTypeNoGOOGLE BUSINESS — the KIND of Post. STANDARD is the default; EVENT and OFFER both REQUIRE `event` (title + start date), and OFFER also takes `offer`.
trialReelNoINSTAGRAM TRIAL REEL — publish this Reel to NON-FOLLOWERS ONLY at first (Instagram allows trials only on accounts above its follower threshold — about 1,000 followers; an ineligible account is refused by name and nothing is posted), so a hook can be tested on a cold audience without spending it on the people who already follow the brand; Instagram shows it to followers only if it graduates. MANUAL = the creator graduates it by hand in the Instagram app; SS_PERFORMANCE = Instagram graduates it automatically if it performs. REELS ONLY and INSTAGRAM ONLY: an image, a carousel, or a Facebook/Threads channel is REFUSED BY NAME rather than quietly published as an ordinary post — a trial that silently goes to every follower is the exact opposite of what was asked for, so Instagram must be one of the `channels` and the item must carry a video. Omit it for a normal Reel.
yourBrandNoTIKTOK — the OWN-BRAND disclosure (brand_organic_toggle): true when the post promotes the creator’s own business. TikTok asks for at least one of this and brandedContent once a post is commercial.
actionTypeNoGOOGLE BUSINESS — the call-to-action button. Every button except CALL needs `link` (CALL dials the number on the listing and takes none). Google IGNORES the button link on an OFFER post — put the destination in offer.redeemOnlineUrl. Omit and a post carrying a link gets LEARN_MORE.
categoryIdNoYOUTUBE: NUMERIC category id (28 Science & Technology, 27 Education, 24 Entertainment, 22 People & Blogs…; list_youtube_categories names them). Checked against YouTube’s assignable list when you schedule. Default 22.
locationIdNoGOOGLE BUSINESS PROFILE — which listing, e.g. 'locations/123' from list_business_locations. Needed when the account manages more than one storefront; it is never chosen for the user.
madeWithAiNoX — X’s AI-media label on this post. Opt-in: X treats it as the poster’s own claim about their media, so it is never set on the user’s behalf.
threadNameNoDISCORD: forum thread title
threadsGifNoTHREADS ONLY — a GIPHY GIF id (the id in a giphy.com/gifs/… link) attached to a TEXT Threads post. GIPHY is the only provider Threads takes.
visibilityNohow it should be published — DEFAULT 'public' (live). Only pass something else if the user explicitly asked to stage/hide it. Not every channel supports every value; an impossible combination is refused when you schedule it, with the reason.
whopPinnedNoWHOP FORUM POSTS ONLY — pin it to the top of the forum.
aiGeneratedNoAI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures, Threads is_made_with_ai). OMIT IT and Hermoso decides from provenance: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override.
atByChannelNoper-channel times, e.g. {"x":"…T09:00"}; others use at/useQueue; each time is its own post
audioVolumeNoINSTAGRAM REEL — how loud that track plays, 0–100 (Instagram’s default 100). Needs audioId.
communityIdNoX — publish into an X COMMUNITY instead of the main timeline: the number in the community’s own URL (x.com/i/communities/<id>). The connected account must be a MEMBER of it.
descriptionNoYOUTUBE: the video DESCRIPTION, max 5000 characters, carrying the links, the CTA and what YouTube search reads. Omit it and the caption is used.
disableDuetNoTIKTOK VIDEO ONLY — block Duets. TikTok’s photo-post API has no Duets, so this is refused on a photo/slideshow item rather than silently dropped.
linkPictureNoFACEBOOK — override the IMAGE of the link preview: a public http(s) url Facebook fetches itself. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager > Brand safety > Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain.
madeForKidsNoYOUTUBE: declare the video MADE FOR KIDS (COPPA). Default false.
quotePostIdNoTHREADS ONLY — the id of the Threads post this one quotes.
shareToFeedNoINSTAGRAM REEL — true puts the Reel in the Feed grid as well as the Reels tab. REELS ONLY. Left unset it follows Instagram’s own default; Hermoso does not flip it either way on the user’s behalf.
shopifyBlogNowhich Shopify blog
thumbOffsetNoINSTAGRAM REEL COVER, the other way — which frame becomes the cover, in MILLISECONDS from the start of the video. REELS ONLY. Use it instead of `coverUrl` when the right cover is already a frame of the clip.
videoVolumeNoINSTAGRAM REEL — how loud the video’s own sound plays under the track, 0–100 (Instagram’s default 100; 0 = the track alone). Needs audioId.
whopMentionNoWHOP FORUM POSTS ONLY — notify every member (off by default).
brandPartnerNoYOUTUBE: sponsoring brand channel (UC… or @handle). Carried to the upload when the post fires.
callToActionNoFACEBOOK — a real call-to-action BUTTON on the Page post. The types that open a destination (SHOP_NOW, LEARN_MORE, SIGN_UP, BUY_NOW, DOWNLOAD, OPEN_LINK, WATCH_MORE, BOOK_TRAVEL) need somewhere to go: the post’s own `link`, or `callToActionLink`. CALL_NOW, MESSAGE_PAGE, LIKE_PAGE and GET_DIRECTIONS act on the Page itself and take none.
captionTrackNoYOUTUBE: a subtitle track (SRT or WebVTT) uploaded right after the video goes up. Pass url (a Hermoso-hosted file — upload_file returns one) OR text (the file body), plus language (BCP-47, required). If the caption upload fails the video is still posted and the result row carries the exact manage_youtube_caption call to retry just the track.
countryCodesNoTHREADS ONLY — two-letter country codes to limit who can see the post. Omit to show it everywhere.
firstCommentNoFIRST COMMENT — posted on each new post as the same account right after it publishes, on Facebook, Instagram and LinkedIn company Pages (LinkedIn needs its comments authorization, provider linkedin_community). Other channels publish without it and their result row says so. Up to 2,000 characters, refused rather than cut; never on a story. A failed comment never undoes the post.
optimizeCopyNoRECOMMENDED when one caption goes to several channels: fit the shared caption to each channel’s own rules when you schedule it (the fitted caption is stored on the scheduled post, so what you scheduled is what publishes) wherever no per-channel caption was written. The angle and every claim stay the author’s; a channel with its own caption is left exactly as written. Off by default so nobody’s words are rewritten unasked.
privacyLevelNoTIKTOK — WHICH PRIVACY LEVEL the post goes out at, in TikTok’s own vocabulary. TikTok requires the USER to choose this from the levels their own account allows: call tiktok_creator_info, show them the real options, and pass back the one they picked — never a default and never a guess, which TikTok refuses at init. Omit it and the post falls back to the coarse `visibility` (private -> SELF_ONLY, otherwise PUBLIC_TO_EVERYONE), which cannot express MUTUAL_FOLLOW_FRIENDS or FOLLOWER_OF_CREATOR at all. It must agree with the TikTok visibility (SELF_ONLY is the private one) and it is refused on a TikTok DRAFT, which carries no post info.
replyControlNoTHREADS ONLY — who may reply. Omit for Threads' own default (everyone).
slackChannelNoSLACK app: channel id or #name (default: the brand's)
thumbnailUrlNoYOUTUBE: the custom thumbnail, a Hermoso-hosted image (make_thumbnail, or upload_file for the user’s own). Omit it and a frame of the video is used; "auto" keeps YouTube’s pick.
wpCategoriesNoWORDPRESS — categories (names or ids)
xQuotePostIdNoX — the numeric id of an X post this one QUOTES: the last part of its URL. NAMED xQuotePostId, NOT quotePostId, because `quotePostId` on this same schedule belongs to THREADS. Billed at X’s higher LINK rate.
collaboratorsNoINSTAGRAM — a COLLAB post: up to 3 Instagram usernames invited to CO-AUTHOR it, so it appears on their profile too once they accept, with both handles in the header and the engagement shared. Handles only ("hermosoai"); a leading @ is fine. Instagram must be one of the `channels` — asking for collaborators on a schedule Instagram is not on is REFUSED now rather than discovered when it fires, and the other channels in a mixed schedule simply publish without co-authors. THE INVITE IS SENT WHEN THE POST FIRES, not when you schedule it, and it is PENDING until the other account accepts in their notifications; check with instagram_collaborators afterwards rather than telling the user it is live on both profiles.
coverImageUrlNoTHE VIDEO COVER as a picture instead of a frame — a Hermoso-hosted image (upload_file). Every channel that takes a cover image gets it (Instagram, Facebook, LinkedIn Page, Pinterest, Telegram, YouTube); TikTok takes only a frame. Never together with coverAtMs.
disableStitchNoTIKTOK VIDEO ONLY — block Stitches. Same photo-post rule as disableDuet.
discordExtrasNoDISCORD: {embeds, poll, tts, crosspost}
discordServerNoDISCORD bot: which server
instagramPollNoINSTAGRAM — attach a POLL: 2 to 4 answers of 1–25 characters each, and the caption IS the question (so a caption is required). Feed photos, carousels and Reels only (never a story), one caption add-on per post (not with instagramCommentPrompt), and only on an account connected through Meta (a Facebook Page with a linked Instagram). WRITE-ONCE: Instagram cannot add, change or remove it after publishing, so show the user the answers first.
platformCoverNoVIDEO COVER. Omit it (the default) and Hermoso sets the video’s best frame — the same frame as its Library thumbnail — as the cover on every channel that allows one (Instagram, Facebook, TikTok direct posts, LinkedIn Pages, Pinterest, Telegram, YouTube) — and on X, Threads and Bluesky, which have none, a blank first frame is replaced on a copy sent there only. true = send no cover and let the platform pick (usually the first frame). A cover you pass yourself always wins.
replySettingsNoX — who may reply. Omit for everyone, which is the right default for a brand post.
slackThreadTsNoSLACK app: reply in this thread (parent ts)
webflowFieldsNoWEBFLOW: required collection fields by slug, e.g. {author:"<item id>"}
brandedContentNoTIKTOK — the PAID-PARTNERSHIP disclosure (TikTok’s brand_content_toggle): true when this post promotes a THIRD-PARTY business. It is a compliance declaration, not a preference — set it whenever the post is sponsored. TikTok only accepts branded content on a public or friends-only post, so it cannot ride a private/SELF_ONLY or draft TikTok item and the schedule is refused with the reason.
channelOptionsNorare per-channel extras: threadsChain[] / blueskyThread[] follow-ups threaded under it; linkedinPoll {question, options[], duration ONE_DAY|THREE_DAYS|SEVEN_DAYS|FOURTEEN_DAYS} a poll as the post; linkedinReshareOf repost this (link or urn); ytPlaylistId add to playlist; protectContent Telegram no forwarding/saving; telegramDocument file URL sent as the post; slackUsername / slackIconUrl / slackIconEmoji (:rocket:) the Slack app posts as that name and picture
disableCommentNoTIKTOK — turn comments off on this post.
disablePreviewNoTELEGRAM ONLY — no link preview.
discordChannelNoDISCORD bot: channel id or #name (default: the brand's)
discordReplyToNoDISCORD bot: reply to this message id
linkAttachmentNoTHREADS ONLY — a full http(s) URL rendered as a link card. This is the ONLY way a Threads post carries a destination, and Threads attaches it to TEXT-ONLY posts (a post with media cannot also carry a card).
seoDescriptionNoblog search description
slackWorkspaceNoSLACK app: which workspace
targetAudienceNoLINKEDIN COMPANY PAGE POST ONLY — show the post only to Page followers matching these facets (URNs or bare numeric ids; search_linkedin_ads_targeting finds them). LinkedIn requires the matching audience to be over 300 followers and refuses a smaller one. Personal-profile posts cannot be targeted.
whopVisibilityNoWHOP FORUM POSTS ONLY — who can see it; unset is the forum’s own default.
discordMentionsNoDISCORD: let mentions ping
linkDescriptionNoFACEBOOK — override the DESCRIPTION of the link preview. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager > Brand safety > Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain.
paidPartnershipNoINSTAGRAM AND X — the PAID PARTNERSHIP label, a compliance declaration: set it when the post is sponsored, gifted or otherwise paid for. OPT-IN ONLY, never assume it on the user’s behalf. On Instagram, brandedContentSponsorIds names the brands behind it.
threadsLongTextNoTHREADS ONLY — LONG-FORM text, up to 10,000 characters, attached under a TEXT-only Threads post (Threads' text attachment). The way to publish more than Threads' 500-character post: keep a short lead in the message and put the full text here. Not with an image, video or carousel.
callToActionLinkNoFACEBOOK — where the button goes, when that is not the post’s own `link`.
coverTimestampMsNoTIKTOK VIDEO ONLY — which frame TikTok uses as the cover, in milliseconds from the start. Omit and Hermoso uses the video’s best frame (platformCover:true leaves it to TikTok, which uses the first frame).
crossreshareToIgNoTHREADS ONLY — when this fires, ALSO share it to the linked Instagram account as a STORY. Refused on a Threads carousel. No confirmation exists that the Story was created, so the result says it was requested.
threadsGhostPostNoTHREADS ONLY — a GHOST post: text only, Threads archives it automatically after 24 hours (a flash offer, a 24h-only note). No other Threads option can ride it.
whopExperienceIdNoWHOP — which forum or chat in the whop (exp_…, from list_whop_destinations). Omit it when the whop has only one; with several and none named the post is refused at fire time, never guessed.
whopPaywallCentsNoWHOP FORUM POSTS ONLY — a paywall in cents (500 = $5.00): readers pay to see the body; needs a title.
commercialContentNoTIKTOK — the COMMERCIAL CONTENT DISCLOSURE toggle: true when the post promotes a brand, product or service at all. TikTok requires at least one of yourBrand / brandedContent alongside it, and a post declaring itself commercial without naming which kind is refused. Setting either disclosure already implies this, so it is only needed to be explicit.
notifySubscribersNoYOUTUBE: notify subscribers when it goes live. Omit to follow the privacy (public notifies, unlisted/private do not); true announces anyway, false stays quiet even when public.
discordStartThreadNoDISCORD bot: open a thread under the post, this title
instagramLocationIdNoINSTAGRAM — tag a place (called locationId on post_to_meta; locationId here is the Google Business listing). It is the pageId from search_meta_places, the NUMERIC ID OF A FACEBOOK PAGE associated with that location, not a place name and not coordinates; a non-numeric value is refused rather than sent.
visibilityByChannelNooverride visibility for one channel, e.g. { "tiktok": "draft" } to go live everywhere but stage TikTok for review
whopPaywallCurrencyNoWHOP — the paywall currency, a 3-letter code (default usd).
crossreshareDarkModeNoTHREADS ONLY — render that Instagram Story in dark mode. Needs crossreshareToIg.
paidProductPlacementNoYOUTUBE: paid product placement (shows the disclosure). Carried to the upload when the post fires.
instagramPollExtendedNoINSTAGRAM — give that poll Instagram’s extended voting duration instead of its default 3 days (Instagram’s changelog says it then stays open indefinitely). Only with instagramPoll.
instagramCommentPromptNoINSTAGRAM — make the caption a COMMENT PROMPT that people answer in the comments. Same limits as instagramPoll, and never together with it.
linkedinOrganizationIdNoLINKEDIN — publish as a COMPANY PAGE instead of the connected personal profile. The organization id from list_linkedin_pages. Omit and it posts as the person: an unset id means the profile, never “probably the company”. A Page can also carry VIDEO, which a personal profile cannot.
brandedContentSponsorIdsNoINSTAGRAM — the numeric Instagram USER IDS of the brands behind that label (at most 2, and ids rather than @handles). Naming sponsors IS asking for the label, so setting these with `paidPartnership:false` is refused instead of publishing brand credits with no disclosure.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changedv0.1.571
    • addedInput schema / properties / atByChannel
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "per-channel times, e.g. {\"x\":\"…T09:00\"}; others use at/useQueue; each time is its own post",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / blogSlug
      Added value: +{
      +  "description": "blog post slug",
      +  "type": "string"
      +}
    • addedInput schema / properties / blogTags
      Added value: +{
      +  "description": "Shopify blog / Wix tags",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / channelOptions
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "rare per-channel extras: threadsChain[] / blueskyThread[] follow-ups threaded under it; linkedinPoll {question, options[], duration ONE_DAY|THREE_DAYS|SEVEN_DAYS|FOURTEEN_DAYS} a poll as the post; linkedinReshareOf repost this (link or urn); ytPlaylistId add to playlist; protectContent Telegram no forwarding/saving; telegramDocument file URL sent as the post; slackUsername / slackIconUrl / slackIconEmoji (:rocket:) the Slack app posts as that name and picture",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / channels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram",
      -  "wordpress",
      -  "discord",
      -  "slack",
      -  "whop"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop",
      +  "shopify_blog",
      +  "webflow",
      +  "wix"
      +]
    • addedInput schema / properties / discordExtras
      Added value: +{
      +  "description": "DISCORD: {embeds, poll, tts, crosspost}"
      +}
    • changedInput schema / properties / excerpt / description
      Previous value: -"WORDPRESS — the excerpt under the title"New value: +"BLOG — the excerpt under the title"
    • addedInput schema / properties / seoDescription
      Added value: +{
      +  "description": "blog search description",
      +  "type": "string"
      +}
    • addedInput schema / properties / seoTitle
      Added value: +{
      +  "description": "blog search title",
      +  "type": "string"
      +}
    • addedInput schema / properties / shopifyBlog
      Added value: +{
      +  "description": "which Shopify blog",
      +  "type": "string"
      +}
    • changedInput schema / properties / useQueue / description
      Previous value: -"instead of naming a minute, drop this into the brand’s POSTING QUEUE: Hermoso takes the earliest of its saved posting times that is still free (skipping any slot another queued post already holds). This is the natural answer to “just queue it” / “post it at my next opening”. Mutually exclusive with `at` — passing both is refused rather than one being silently preferred. If the profile has no posting times set, or every slot for the next 90 days is taken, it is refused by name and nothing is scheduled."New value: +"take the next free slot in a posting queue (“just queue it”): true = default queue, or a queue name (manage_post_queues). Not with `at`; refused by name when no slot is free."
    • changedInput schema / properties / useQueue / type
      Previous value: -"boolean"New value: +[
      +  "boolean",
      +  "string"
      +]
    • addedInput schema / properties / webflowFields
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "WEBFLOW: required collection fields by slug, e.g. {author:\"<item id>\"}",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  2. Changed6 schema fields changedv0.1.532
    • changedInput schema / properties / brandPartner / description
      Previous value: -"YOUTUBE: sponsoring brand channel (UC… or @handle)"New value: +"YOUTUBE: sponsoring brand channel (UC… or @handle). Carried to the upload when the post fires."
    • addedInput schema / properties / captionTrack
      Added value: +{
      +  "description": "YOUTUBE: a subtitle track (SRT or WebVTT) uploaded right after the video goes up. Pass url (a Hermoso-hosted file — upload_file returns one) OR text (the file body), plus language (BCP-47, required). If the caption upload fails the video is still posted and the result row carries the exact manage_youtube_caption call to retry just the track.",
      +  "properties": {
      +    "language": {
      +      "type": "string"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "language"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / categoryId
      Added value: +{
      +  "description": "YOUTUBE: NUMERIC category id (28 Science & Technology, 27 Education, 24 Entertainment, 22 People & Blogs…; list_youtube_categories names them). Checked against YouTube’s assignable list when you schedule. Default 22.",
      +  "type": "string"
      +}
    • addedInput schema / properties / madeForKids
      Added value: +{
      +  "description": "YOUTUBE: declare the video MADE FOR KIDS (COPPA). Default false.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / notifySubscribers
      Added value: +{
      +  "description": "YOUTUBE: notify subscribers when it goes live. Omit to follow the privacy (public notifies, unlisted/private do not); true announces anyway, false stays quiet even when public.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / paidProductPlacement / description
      Previous value: -"YOUTUBE: paid product placement (shows the disclosure)"New value: +"YOUTUBE: paid product placement (shows the disclosure). Carried to the upload when the post fires."
  3. Changed2 schema fields changedv0.1.525
    • changedInput schema / properties / imageUrl / description
      Previous value: -"a Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL. NOTE: only Facebook/Instagram/Threads accept an arbitrary public URL — X, TikTok, YouTube, LinkedIn, Pinterest and Google Business re-host the bytes and REFUSE anything that is not a Hermoso render, so run an external file through upload_file first and schedule that url."New value: +"a Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL. NOTE: only Facebook/Instagram/Threads accept an arbitrary public URL — X, TikTok, YouTube, LinkedIn, Pinterest and Google Business re-host the bytes and REFUSE anything that is not a Hermoso render, so run an external file through upload_file first and schedule that url; a URL, not a local file path; use upload_file for local files"
    • changedInput schema / properties / videoUrl / description
      Previous value: -"a Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL — required for youtube, and for tiktok unless you pass an imageUrl (TikTok takes a photo post too). Same origin rule as imageUrl: everything except Facebook/Instagram/Threads REFUSES a non-Hermoso URL, so pass external video through upload_file first."New value: +"a Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL — required for youtube, and for tiktok unless you pass an imageUrl (TikTok takes a photo post too). Same origin rule as imageUrl: everything except Facebook/Instagram/Threads REFUSES a non-Hermoso URL, so pass external video through upload_file first; a URL, not a local file path; use upload_file for local files"
  4. Changed24 schema fields changedv0.1.519
    • changedInput schema / properties / channels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop"
      +]
    • addedInput schema / properties / discordChannel
      Added value: +{
      +  "description": "DISCORD bot: channel id or #name (default: the brand's)",
      +  "type": "string"
      +}
    • addedInput schema / properties / discordMentions
      Added value: +{
      +  "description": "DISCORD: let mentions ping",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / discordReplyTo
      Added value: +{
      +  "description": "DISCORD bot: reply to this message id",
      +  "type": "string"
      +}
    • addedInput schema / properties / discordServer
      Added value: +{
      +  "description": "DISCORD bot: which server",
      +  "type": "string"
      +}
    • addedInput schema / properties / discordStartThread
      Added value: +{
      +  "description": "DISCORD bot: open a thread under the post, this title",
      +  "type": "string"
      +}
    • addedInput schema / properties / excerpt
      Added value: +{
      +  "description": "WORDPRESS — the excerpt under the title",
      +  "type": "string"
      +}
    • changedInput schema / properties / pageId / description
      Previous value: -"FACEBOOK / INSTAGRAM / THREADS — which connected Facebook Page (and its linked Instagram) publishes, from list_meta_pages. Needed when the profile has more than one Page connected; with several and no id the post is refused at fire time rather than sent from the wrong brand."New value: +"FACEBOOK / INSTAGRAM / THREADS — which connected Facebook Page (and its linked Instagram) publishes, from list_meta_pages. Needed when the profile has more than one Page connected: a Facebook post with several and no id is refused WHEN YOU SCHEDULE IT, with the Pages listed by name and id, so ask the user which Page and schedule again with its id. It is never sent from a guessed Page."
    • changedInput schema / properties / silent / description
      Previous value: -"TELEGRAM ONLY — no notification sound."New value: +"TELEGRAM / DISCORD — no notification."
    • addedInput schema / properties / slackChannel
      Added value: +{
      +  "description": "SLACK app: channel id or #name (default: the brand's)",
      +  "type": "string"
      +}
    • addedInput schema / properties / slackThreadTs
      Added value: +{
      +  "description": "SLACK app: reply in this thread (parent ts)",
      +  "type": "string"
      +}
    • addedInput schema / properties / slackWorkspace
      Added value: +{
      +  "description": "SLACK app: which workspace",
      +  "type": "string"
      +}
    • changedInput schema / properties / story / description
      Previous value: -"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A link sticker cannot be added through Meta’s publishing API on either channel: add it in the Instagram app. An Instagram Story keeps its caption: people see the start under the Story in the app and tap for the rest (instagram.com does not show it). It takes NO collaborators, product tags or trialReel — any of those is refused by name and nothing is posted. FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."New value: +"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. Link stickers are not available on a Story posted here. An Instagram Story keeps its caption: people see the start under the Story in the mobile app and tap for the rest. It takes NO collaborators, product tags or trialReel — any of those is refused by name and nothing is posted. FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."
    • addedInput schema / properties / threadName
      Added value: +{
      +  "description": "DISCORD: forum thread title",
      +  "type": "string"
      +}
    • addedInput schema / properties / whopExperienceId
      Added value: +{
      +  "description": "WHOP — which forum or chat in the whop (exp_…, from list_whop_destinations). Omit it when the whop has only one; with several and none named the post is refused at fire time, never guessed.",
      +  "type": "string"
      +}
    • addedInput schema / properties / whopMention
      Added value: +{
      +  "description": "WHOP FORUM POSTS ONLY — notify every member (off by default).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / whopPaywallCents
      Added value: +{
      +  "description": "WHOP FORUM POSTS ONLY — a paywall in cents (500 = $5.00): readers pay to see the body; needs a title.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / whopPaywallCurrency
      Added value: +{
      +  "description": "WHOP — the paywall currency, a 3-letter code (default usd).",
      +  "type": "string"
      +}
    • addedInput schema / properties / whopPinned
      Added value: +{
      +  "description": "WHOP FORUM POSTS ONLY — pin it to the top of the forum.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / whopPoll
      Added value: +{
      +  "description": "WHOP FORUM POSTS ONLY — a poll: 2 to 10 options, in order.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / whopVisibility
      Added value: +{
      +  "description": "WHOP FORUM POSTS ONLY — who can see it; unset is the forum’s own default.",
      +  "enum": [
      +    "members_only",
      +    "globally_visible"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / wpCategories
      Added value: +{
      +  "description": "WORDPRESS — categories (names or ids)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / wpSlug
      Added value: +{
      +  "description": "WORDPRESS — the post slug",
      +  "type": "string"
      +}
    • addedInput schema / properties / wpTags
      Added value: +{
      +  "description": "WORDPRESS — tags (names or ids)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  5. Changed1 schema field changedv0.1.489
    • changedInput schema / properties / story / description
      Previous value: -"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A Story takes NO CAPTION, collaborators, product tags or trialReel — any of those is refused by name and nothing is posted (a story must never silently drop your words). FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."New value: +"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A link sticker cannot be added through Meta’s publishing API on either channel: add it in the Instagram app. An Instagram Story keeps its caption: people see the start under the Story in the app and tap for the rest (instagram.com does not show it). It takes NO collaborators, product tags or trialReel — any of those is refused by name and nothing is posted. FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."
  6. Changed5 schema fields changedv0.1.484
    • changedInput schema / properties / aiGenerated / description
      Previous value: -"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures). OMIT IT and Hermoso decides from provenance: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override."New value: +"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures, Threads is_made_with_ai). OMIT IT and Hermoso decides from provenance: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override."
    • changedInput schema / properties / instagramLocationId / description
      Previous value: -"INSTAGRAM — tag a place (called locationId on post_to_meta; locationId here is the Google Business listing). It is the NUMERIC ID OF A FACEBOOK PAGE associated with that location, not a place name and not coordinates; a non-numeric value is refused rather than sent."New value: +"INSTAGRAM — tag a place (called locationId on post_to_meta; locationId here is the Google Business listing). It is the pageId from search_meta_places, the NUMERIC ID OF A FACEBOOK PAGE associated with that location, not a place name and not coordinates; a non-numeric value is refused rather than sent."
    • changedInput schema / properties / place / description
      Previous value: -"FACEBOOK — tag a location on the Page post. The NUMERIC ID OF THE FACEBOOK PAGE for that place, not a place name and not coordinates."New value: +"FACEBOOK — tag a location on the Page post. The pageId from search_meta_places: the NUMERIC ID OF THE FACEBOOK PAGE for that place, not a place name and not coordinates."
    • addedInput schema / properties / placeName
      Added value: +{
      +  "description": "the name the user saw for that place; a different business is refused",
      +  "type": "string"
      +}
    • changedInput schema / properties / story / description
      Previous value: -"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A Story carries NO CAPTION (there is nowhere to show one), no collaborators, no product tags and no trialReel — passing any of those is refused by name and nothing is posted, because a story that silently drops the words is worse than one that never went. FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."New value: +"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A Story takes NO CAPTION, collaborators, product tags or trialReel — any of those is refused by name and nothing is posted (a story must never silently drop your words). FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."
  7. Changed39 schema fields changedv0.1.465
    • changedInput schema / properties / aiGenerated / description
      Previous value: -"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia). OMIT IT and Hermoso decides from provenance: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override."New value: +"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia, Pinterest ai_disclosures). OMIT IT and Hermoso decides from provenance: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override."
    • addedInput schema / properties / audience / properties / minAge / description
      Added value: +"Facebook Page post audience: minimum age, one of 13, 15, 18, 21 or 25"
    • addedInput schema / properties / brandPartner
      Added value: +{
      +  "description": "YOUTUBE: sponsoring brand channel (UC… or @handle)",
      +  "type": "string"
      +}
    • addedInput schema / properties / buttons
      Added value: +{
      +  "description": "TELEGRAM ONLY — URL buttons under the post, as post_to_telegram takes them; never on an album.",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "properties": {
      +          "style": {
      +            "enum": [
      +              "danger",
      +              "success",
      +              "primary"
      +            ],
      +            "type": "string"
      +          },
      +          "text": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "text",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "items": {
      +          "properties": {
      +            "style": {
      +              "enum": [
      +                "danger",
      +                "success",
      +                "primary"
      +              ],
      +              "type": "string"
      +            },
      +            "text": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "text",
      +            "url"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / chatId / description
      Previous value: -"TELEGRAM — REQUIRED whenever telegram is a channel: WHICH chat, group or channel the bot posts to. A public channel’s @username (@hermosoai) or the numeric id (a group is negative; a supergroup or channel starts with -100). There is no default and there cannot be one — the Telegram Bot API publishes no method that lists a bot’s chats — so scheduling telegram without one is refused up front. list_telegram_chats finds ids for chats that have messaged the bot in the last 24 hours."New value: +"TELEGRAM — REQUIRED whenever telegram is a channel: WHICH chat, group or channel the bot posts to. A public channel’s @username (@yourchannel) or the numeric id (a group is negative; a supergroup or channel starts with -100). There is no default and there cannot be one — the Telegram Bot API publishes no method that lists a bot’s chats — so scheduling telegram without one is refused up front. list_telegram_chats finds ids for chats that have messaged the bot in the last 24 hours."
    • addedInput schema / properties / disablePreview
      Added value: +{
      +  "description": "TELEGRAM ONLY — no link preview.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / event / properties / endDate / description
      Added value: +"event end date, e.g. 2026-11-01"
    • addedInput schema / properties / event / properties / endTime / description
      Added value: +"event end time, e.g. 20:00"
    • addedInput schema / properties / event / properties / startDate / description
      Added value: +"event start date, e.g. 2026-11-01"
    • addedInput schema / properties / event / properties / startTime / description
      Added value: +"event start time, e.g. 18:00"
    • addedInput schema / properties / event / properties / title / description
      Added value: +"Google Business event title; required for an event or offer post"
    • addedInput schema / properties / firstComment
      Added value: +{
      +  "description": "FIRST COMMENT — posted on each new post as the same account right after it publishes, on Facebook, Instagram and LinkedIn company Pages (LinkedIn needs its comments authorization, provider linkedin_community). Other channels publish without it and their result row says so. Up to 2,000 characters, refused rather than cut; never on a story. A failed comment never undoes the post.",
      +  "type": "string"
      +}
    • changedInput schema / properties / imageUrls / description
      Previous value: -"CAROUSEL — an ORDERED list of image URLs to publish as ONE swipeable post on every channel that supports it (Instagram 2–10, Threads 2–20, Facebook, LinkedIn company Pages 2–20, Pinterest 2–5, TikTok up to 35 as a photo post). Use this whenever the creative is a multi-slide deck: a scheduled post carrying only slide 1 of a “1/6 · SWIPE” set is a broken ad that nobody is watching when it fires. THE ORDER IS THE PRODUCT. A channel on this schedule that cannot do carousels — X, YouTube, Google Business Profile — is REFUSED NOW, with the reason, so you can drop it or give it its own single image; it is never quietly downgraded hours later."New value: +"CAROUSEL — an ORDERED list of image URLs to publish as ONE swipeable post on every channel that supports it (Instagram 2–20, Threads 2–20, Facebook, LinkedIn company Pages 2–20, Pinterest 2–5, TikTok up to 35 as a photo post). Use this whenever the creative is a multi-slide deck: a scheduled post carrying only slide 1 of a “1/6 · SWIPE” set is a broken ad that nobody is watching when it fires. THE ORDER IS THE PRODUCT. A channel on this schedule that cannot do carousels — X, YouTube, Google Business Profile — is REFUSED NOW, with the reason, so you can drop it or give it its own single image; it is never quietly downgraded hours later."
    • addedInput schema / properties / offer / properties / couponCode / description
      Added value: +"Google Business offer coupon code"
    • addedInput schema / properties / offer / properties / redeemOnlineUrl / description
      Added value: +"link where the offer is redeemed online"
    • addedInput schema / properties / offer / properties / termsConditions / description
      Added value: +"terms text shown with the offer"
    • addedInput schema / properties / paidProductPlacement
      Added value: +{
      +  "description": "YOUTUBE: paid product placement (shows the disclosure)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / parseMode
      Added value: +{
      +  "description": "TELEGRAM ONLY — 'HTML' for Telegram's HTML tags; omit for plain text.",
      +  "enum": [
      +    "HTML"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / poll / properties / durationMinutes / description
      Added value: +"X poll length in minutes, 5 to 10080; default 1440 (one day)"
    • addedInput schema / properties / poll / properties / options / description
      Added value: +"X poll choices: 2 to 4 options, max 25 characters each"
    • addedInput schema / properties / silent
      Added value: +{
      +  "description": "TELEGRAM ONLY — no notification sound.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / slideText / items / properties / description / description
      Added value: +"Pinterest carousel slide: description for this slide"
    • addedInput schema / properties / slideText / items / properties / link / description
      Added value: +"Pinterest carousel slide: destination URL for this slide"
    • addedInput schema / properties / slideText / items / properties / title / description
      Added value: +"Pinterest carousel slide: title for this slide"
    • changedInput schema / properties / story / description
      Previous value: -"INSTAGRAM STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A Story carries NO CAPTION (there is nowhere to show one), no collaborators, no product tags and no trialReel — passing any of those is refused by name and nothing is posted, because a story that silently drops the words is worse than one that never went. INSTAGRAM ONLY: a Facebook Page story is a different upload and is not built, so a Facebook channel with `story` set is refused rather than published to the feed."New value: +"INSTAGRAM OR FACEBOOK PAGE STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A Story carries NO CAPTION (there is nowhere to show one), no collaborators, no product tags and no trialReel — passing any of those is refused by name and nothing is posted, because a story that silently drops the words is worse than one that never went. FACEBOOK PAGE STORIES WORK TOO (target facebook): one image, or one vertical 9:16 video of 3–90 seconds, no caption (a message is refused by name), not schedulable natively — use schedule_post to queue one; the reply reads the story back from the Page."
    • addedInput schema / properties / targetAudience / properties / degrees / description
      Added value: +"LinkedIn degree facet: numeric id or urn:li:degree value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / fieldsOfStudy / description
      Added value: +"LinkedIn field of study facet: numeric id or urn:li:fieldOfStudy value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / geoLocations / description
      Added value: +"LinkedIn geo facet: numeric id or urn:li:geo value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / industries / description
      Added value: +"LinkedIn industry facet: numeric id or urn:li:industry value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / jobFunctions / description
      Added value: +"LinkedIn job function facet: numeric id or urn:li:function value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / organizations / description
      Added value: +"LinkedIn school or organization facet: numeric id or urn:li:organization value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / seniorities / description
      Added value: +"LinkedIn seniority facet: numeric id or urn:li:seniority value from search_linkedin_ads_targeting"
    • addedInput schema / properties / targetAudience / properties / staffCountRanges / description
      Added value: +"LinkedIn company size bands, e.g. SIZE_11_TO_50"
    • addedInput schema / properties / threadsGhostPost
      Added value: +{
      +  "description": "THREADS ONLY — a GHOST post: text only, Threads archives it automatically after 24 hours (a flash offer, a 24h-only note). No other Threads option can ride it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / threadsGif
      Added value: +{
      +  "description": "THREADS ONLY — a GIPHY GIF id (the id in a giphy.com/gifs/… link) attached to a TEXT Threads post. GIPHY is the only provider Threads takes.",
      +  "type": "string"
      +}
    • addedInput schema / properties / threadsLongText
      Added value: +{
      +  "description": "THREADS ONLY — LONG-FORM text, up to 10,000 characters, attached under a TEXT-only Threads post (Threads' text attachment). The way to publish more than Threads' 500-character post: keep a short lead in the message and put the full text here. Not with an image, video or carousel.",
      +  "type": "string"
      +}
    • addedInput schema / properties / userTags
      Added value: +{
      +  "description": "INSTAGRAM USER TAGS — tag people (public accounts) on the post; each is notified. Usernames, or { username, x, y } with x/y from 0 to 1 = where the tag sits on the IMAGE (a tag without a position sits at the centre). A Reel tag takes no position; a story position is optional. Not on a carousel (refused by name).",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "properties": {
      +          "username": {
      +            "type": "string"
      +          },
      +          "x": {
      +            "maximum": 1,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "y": {
      +            "maximum": 1,
      +            "minimum": 0,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "username"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / xArticle / properties / headings / description
      Added value: +"blocks (default) keeps real headings; text turns headings into bold lines"
    • addedInput schema / properties / xArticle / properties / title / description
      Added value: +"X Article headline; the post text becomes the article body in markdown"
  8. Changed3 schema fields changedv0.1.454
    • changedInput schema / properties / altText / description
      Previous value: -"ACCESSIBILITY — the screen-reader description of the attached image. ONE STRING describes the picture; on a CAROUSEL it describes EVERY slide. Pass an ARRAY of strings instead to describe each slide separately, aligned to the slide order — that is strictly better on a multi-slide post, because one sentence read out over six different pictures is wrong for five of them. More descriptions than pictures is refused rather than dropped. Write one whenever the post carries an image: describe what is IN the picture, never a repeat of the caption, which a screen reader already reads. CARRIED BY: X (max 1000, one per media), Pinterest (max 500 — PIN-LEVEL only, since its API has no per-item alt text, so slide 1’s description is used for the whole Pin and the result says the others were not sent), LinkedIn COMPANY PAGES (max 4086, one per slide), INSTAGRAM image posts and image slides (max 1000), FACEBOOK photos and albums, and BLUESKY, whose lexicon makes it REQUIRED on every image. The schedule is REFUSED if the LONGEST description exceeds the tightest of the channels on it, rather than truncated on the way out. NOT CARRIED, and none of these is a refusal — the post still publishes, just undescribed there, and the per-channel result says which: TikTok (its photo post has no alt field at any level), a THREADS CAROUSEL, an INSTAGRAM Reel or video slide, and a LinkedIn PERSONAL-profile post."New value: +"ACCESSIBILITY — the screen-reader description of the attached image. ONE STRING describes the picture; on a CAROUSEL it describes EVERY slide. Pass an ARRAY of strings instead to describe each slide separately, aligned to the slide order — use that on a multi-slide post, because one sentence read out over six different pictures is wrong for five of them. More descriptions than pictures is refused rather than dropped. Write one whenever the post carries an image: describe what is IN the picture, never a repeat of the caption, which a screen reader already reads. CARRIED BY: X (max 1000, one per media), Pinterest (max 500 — PIN-LEVEL only, since its API has no per-item alt text, so slide 1’s description is used for the whole Pin and the result says the others were not sent), LinkedIn COMPANY PAGES (max 4086, one per slide), INSTAGRAM image posts and image slides (max 1000), FACEBOOK photos and albums, and BLUESKY, whose lexicon makes it REQUIRED on every image. The schedule is REFUSED if the LONGEST description exceeds the tightest of the channels on it, rather than truncated on the way out. NOT CARRIED, and none of these is a refusal — the post still publishes, just undescribed there, and the per-channel result says which: TikTok (its photo post has no alt field at any level), a THREADS CAROUSEL, an INSTAGRAM Reel or video slide, and a LinkedIn PERSONAL-profile post."
    • changedInput schema / properties / at / description
      Previous value: -"when to post — ISO timestamp (2026-08-01T09:00:00Z) or epoch milliseconds. Must be in the future, at most 365 days out. Give this OR useQueue, never both."New value: +"when to post: local wall clock, no offset (2026-10-30T10:00), read in `timezone` or the brand’s zone ON THAT DATE so a series survives a clock change; or UTC (…Z) / epoch ms. Future, at most 365 days out. Give this OR useQueue, never both."
    • changedInput schema / properties / timezone / description
      Previous value: -"IANA zone for the queue, e.g. \"America/New_York\" — only meaningful with useQueue, and it overrides the brand’s saved zone for this one post. A saved slot of \"09:00\" is a WALL-CLOCK time, so the zone is what turns it into an instant; without either the brand’s saved zone or this, the queue resolves in UTC."New value: +"IANA zone (e.g. \"Africa/Cairo\") a wall-clock `at` or the queue is read in; overrides the brand’s saved zone for this one post. Without either, UTC."
  9. Changed3 schema fields changedv0.1.374
    • changedInput schema / properties / brand / description
      Previous value: -"WHICH BRAND this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no brand, or two, is REFUSED and nothing is posted."New value: +"WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no profile, or two, is REFUSED and nothing is posted."
    • changedInput schema / properties / pageId / description
      Previous value: -"FACEBOOK / INSTAGRAM / THREADS — which connected Facebook Page (and its linked Instagram) publishes, from list_meta_pages. Needed when the brand has more than one Page connected; with several and no id the post is refused at fire time rather than sent from the wrong brand."New value: +"FACEBOOK / INSTAGRAM / THREADS — which connected Facebook Page (and its linked Instagram) publishes, from list_meta_pages. Needed when the profile has more than one Page connected; with several and no id the post is refused at fire time rather than sent from the wrong brand."
    • changedInput schema / properties / useQueue / description
      Previous value: -"instead of naming a minute, drop this into the brand’s POSTING QUEUE: Hermoso takes the earliest of its saved posting times that is still free (skipping any slot another queued post already holds). This is the natural answer to “just queue it” / “post it at my next opening”. Mutually exclusive with `at` — passing both is refused rather than one being silently preferred. If the brand has no posting times set, or every slot for the next 90 days is taken, it is refused by name and nothing is scheduled."New value: +"instead of naming a minute, drop this into the brand’s POSTING QUEUE: Hermoso takes the earliest of its saved posting times that is still free (skipping any slot another queued post already holds). This is the natural answer to “just queue it” / “post it at my next opening”. Mutually exclusive with `at` — passing both is refused rather than one being silently preferred. If the profile has no posting times set, or every slot for the next 90 days is taken, it is refused by name and nothing is scheduled."
  10. Changed3 schema fields changedv0.1.372
    • addedInput schema / properties / instagramCommentPrompt
      Added value: +{
      +  "description": "INSTAGRAM — make the caption a COMMENT PROMPT that people answer in the comments. Same limits as instagramPoll, and never together with it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / instagramPoll
      Added value: +{
      +  "description": "INSTAGRAM — attach a POLL: 2 to 4 answers of 1–25 characters each, and the caption IS the question (so a caption is required). Feed photos, carousels and Reels only (never a story), one caption add-on per post (not with instagramCommentPrompt), and only on an account connected through Meta (a Facebook Page with a linked Instagram). WRITE-ONCE: Instagram cannot add, change or remove it after publishing, so show the user the answers first.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / instagramPollExtended
      Added value: +{
      +  "description": "INSTAGRAM — give that poll Instagram’s extended voting duration instead of its default 3 days (Instagram’s changelog says it then stays open indefinitely). Only with instagramPoll.",
      +  "type": "boolean"
      +}
  11. Changed1 schema field changedv0.1.371
    • changedInput schema / properties / aiGenerated / description
      Previous value: -"INSTAGRAM / FACEBOOK REEL — Meta’s is_ai_generated self-disclosure. OMIT IT and Hermoso decides from provenance: a Hermoso render is declared, media that came through upload_file or from an external URL (the user’s own photographs or footage) is NOT — a real photo must never carry Instagram’s “AI info” label. Pass true or false only to override: false strips the label from something Hermoso would otherwise declare, true declares a render the user uploaded themselves."New value: +"AI-CONTENT DISCLOSURE (Instagram / Facebook Reel is_ai_generated, TikTok is_aigc, YouTube containsSyntheticMedia). OMIT IT and Hermoso decides from provenance: a Hermoso render is declared AI-generated, media that came through upload_file or from an external URL (the user’s own photos or footage) is NOT. Pass true or false only to override."
  12. Changed8 schema fields changedv0.1.320
    • addedInput schema / properties / audioId
      Added value: +{
      +  "description": "INSTAGRAM REEL — put one of Instagram’s OWN licensed music tracks under the Reel: the `id` search_instagram_audio returns. Instagram mixes it in when the Reel is published; nothing is downloaded or re-rendered. REELS ONLY, and only on an Instagram account connected through Meta (a Facebook Page with a linked Instagram), which is Instagram’s own rule — the Instagram connector cannot take it and is refused by name.",
      +  "type": "string"
      +}
    • addedInput schema / properties / audioVolume
      Added value: +{
      +  "description": "INSTAGRAM REEL — how loud that track plays, 0–100 (Instagram’s default 100). Needs audioId.",
      +  "maximum": 100,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / brand / description
      Previous value: -"WHICH BRAND this post belongs to — the id or exact name from list_brands (a workspace shared with you: its profile id). Use it whenever the account has more than one brand and you are not certain which one this connection is pinned to: it beats the pin for THIS CALL ONLY and changes nothing about the connection. A name that matches no brand, or two brands, is REFUSED and nothing is posted — never resolved to the pin, which is the account you were guarding against."New value: +"WHICH BRAND this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no brand, or two, is REFUSED and nothing is posted."
    • addedInput schema / properties / coverAtMs
      Added value: +{
      +  "description": "THE VIDEO COVER on EVERY channel of this post, as ONE frame: milliseconds from the start (7000 = the frame at 7s). Instagram, TikTok, Facebook, LinkedIn Page, Pinterest, Telegram and YouTube all get that frame; X, Threads and Bluesky have no cover setting. A channel’s own field (thumbOffset, coverTimestampMs, coverUrl) wins there and otherwise counts as this.",
      +  "type": "number"
      +}
    • addedInput schema / properties / coverImageUrl
      Added value: +{
      +  "description": "THE VIDEO COVER as a picture instead of a frame — a Hermoso-hosted image (upload_file). Every channel that takes a cover image gets it (Instagram, Facebook, LinkedIn Page, Pinterest, Telegram, YouTube); TikTok takes only a frame. Never together with coverAtMs.",
      +  "type": "string"
      +}
    • changedInput schema / properties / hook / description
      Previous value: -"WHAT ANGLE THIS POST IS BUILT ON — the single most valuable field here, and the only moment it can ever be recorded. post_performance groups on it to answer \"which hooks work\", and it needs 5 posts sharing ONE hook before it will call anything a winner, so REUSE THE SAME WORDING across a campaign instead of rephrasing it every time. Best of all, pass a hook id from list_hooks (e.g. \"direct_callout\", \"mid_problem\", \"before_after\") — those fold onto a stable key however they are spelled, so a whole brand accumulates evidence on one row. Your own wording is fine too; it just only groups when you repeat it exactly. Omitting it means this post can never vote on which hook works."New value: +"WHAT ANGLE this post is built on, recorded only at publish time. post_performance ranks hooks on it (a winner needs 5 posts sharing ONE hook), so pass a list_hooks id (e.g. \"direct_callout\", \"before_after\") or reuse your own wording EXACTLY across a campaign. Omit it and this post never votes on which hook works."
    • changedInput schema / properties / subject / description
      Previous value: -"WHAT THIS POST IS ABOUT — the product, feature, offer or theme (e.g. \"winter coat\", \"free trial\", \"founder story\"). The second grouping axis in post_performance. Same rule as hook: reuse the exact wording so posts about one subject land in one group."New value: +"WHAT THIS POST IS ABOUT — product, feature, offer or theme (e.g. \"winter coat\", \"free trial\"). post_performance's second grouping axis: reuse the exact wording, as with hook."
    • addedInput schema / properties / videoVolume
      Added value: +{
      +  "description": "INSTAGRAM REEL — how loud the video’s own sound plays under the track, 0–100 (Instagram’s default 100; 0 = the track alone). Needs audioId.",
      +  "maximum": 100,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  13. Changed2 schema fields changedv0.1.281
    • addedInput schema / properties / ideaId
      Added value: +{
      +  "description": "short id of the content-plan idea this post came from",
      +  "type": "string"
      +}
    • addedInput schema / properties / recipe
      Added value: +{
      +  "description": "the post's FORMAT id, e.g. \"slideshow\" or \"imessage_chat\" — post_performance groups by it, so reuse one id per format",
      +  "type": "string"
      +}
  14. Changed4 schema fields changedv0.1.272
    • changedInput schema / properties / linkDescription / description
      Previous value: -"FACEBOOK — override the DESCRIPTION of the link preview. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager ▸ Brand safety ▸ Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain."New value: +"FACEBOOK — override the DESCRIPTION of the link preview. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager > Brand safety > Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain."
    • changedInput schema / properties / linkName / description
      Previous value: -"FACEBOOK — override the HEADLINE of the link preview. Without it the post shows whatever Open Graph title the destination carries, which on a bare landing page is often nothing. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager ▸ Brand safety ▸ Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain."New value: +"FACEBOOK — override the HEADLINE of the link preview. Without it the post shows whatever Open Graph title the destination carries, which on a bare landing page is often nothing. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager > Brand safety > Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain."
    • changedInput schema / properties / linkPicture / description
      Previous value: -"FACEBOOK — override the IMAGE of the link preview: a public http(s) url Facebook fetches itself. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager ▸ Brand safety ▸ Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain."New value: +"FACEBOOK — override the IMAGE of the link preview: a public http(s) url Facebook fetches itself. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager > Brand safety > Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain."
    • changedInput schema / properties / privacyLevel / description
      Previous value: -"TIKTOK — WHICH PRIVACY LEVEL the post goes out at, in TikTok’s own vocabulary. TikTok requires the USER to choose this from the levels their own account allows: call tiktok_creator_info, show them the real options, and pass back the one they picked — never a default and never a guess, which TikTok refuses at init. Omit it and the post falls back to the coarse `visibility` (private → SELF_ONLY, otherwise PUBLIC_TO_EVERYONE), which cannot express MUTUAL_FOLLOW_FRIENDS or FOLLOWER_OF_CREATOR at all. It must agree with the TikTok visibility (SELF_ONLY is the private one) and it is refused on a TikTok DRAFT, which carries no post info."New value: +"TIKTOK — WHICH PRIVACY LEVEL the post goes out at, in TikTok’s own vocabulary. TikTok requires the USER to choose this from the levels their own account allows: call tiktok_creator_info, show them the real options, and pass back the one they picked — never a default and never a guess, which TikTok refuses at init. Omit it and the post falls back to the coarse `visibility` (private -> SELF_ONLY, otherwise PUBLIC_TO_EVERYONE), which cannot express MUTUAL_FOLLOW_FRIENDS or FOLLOWER_OF_CREATOR at all. It must agree with the TikTok visibility (SELF_ONLY is the private one) and it is refused on a TikTok DRAFT, which carries no post info."
  15. Changed2 schema fields changedv0.1.256
    • changedInput schema / properties / coverTimestampMs / description
      Previous value: -"TIKTOK VIDEO ONLY — which frame TikTok uses as the cover, in milliseconds from the start. Omit and TikTok uses the first frame."New value: +"TIKTOK VIDEO ONLY — which frame TikTok uses as the cover, in milliseconds from the start. Omit and Hermoso uses the video’s best frame (platformCover:true leaves it to TikTok, which uses the first frame)."
    • addedInput schema / properties / platformCover
      Added value: +{
      +  "description": "VIDEO COVER. Omit it (the default) and Hermoso sets the video’s best frame — the same frame as its Library thumbnail — as the cover on every channel that allows one (Instagram, Facebook, TikTok direct posts, LinkedIn Pages, Pinterest, Telegram, YouTube) — and on X, Threads and Bluesky, which have none, a blank first frame is replaced on a copy sent there only. true = send no cover and let the platform pick (usually the first frame). A cover you pass yourself always wins.",
      +  "type": "boolean"
      +}
  16. Changed17 schema fields changedv0.1.251
    • addedInput schema / properties / audience
      Added value: +{
      +  "description": "FACEBOOK PAGE POST ONLY — limit who can see this organic post to people in these places and/or over this age (Facebook allows 13, 15, 18, 21 or 25). Not on Instagram, Threads or a Facebook Reel (a vertical clip becomes a Reel): those are refused. Region and city keys come from the Meta ads location search.",
      +  "properties": {
      +    "cities": {
      +      "description": "Meta location keys for cities",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "countries": {
      +      "description": "two-letter codes, e.g. [\"CA\",\"US\"]",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "minAge": {
      +      "anyOf": [
      +        {
      +          "const": 13,
      +          "type": "number"
      +        },
      +        {
      +          "const": 15,
      +          "type": "number"
      +        },
      +        {
      +          "const": 18,
      +          "type": "number"
      +        },
      +        {
      +          "const": 21,
      +          "type": "number"
      +        },
      +        {
      +          "const": 25,
      +          "type": "number"
      +        }
      +      ]
      +    },
      +    "regions": {
      +      "description": "Meta location keys for regions/states",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / audioName
      Added value: +{
      +  "description": "INSTAGRAM REEL — the name of the Reel’s audio track, which is what viewers tap through to. REELS ONLY.",
      +  "type": "string"
      +}
    • addedInput schema / properties / brand
      Added value: +{
      +  "description": "WHICH BRAND this post belongs to — the id or exact name from list_brands (a workspace shared with you: its profile id). Use it whenever the account has more than one brand and you are not certain which one this connection is pinned to: it beats the pin for THIS CALL ONLY and changes nothing about the connection. A name that matches no brand, or two brands, is REFUSED and nothing is posted — never resolved to the pin, which is the account you were guarding against.",
      +  "type": "string"
      +}
    • addedInput schema / properties / brandedContentSponsorIds
      Added value: +{
      +  "description": "INSTAGRAM — the numeric Instagram USER IDS of the brands behind that label (at most 2, and ids rather than @handles). Naming sponsors IS asking for the label, so setting these with `paidPartnership:false` is refused instead of publishing brand credits with no disclosure.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / callToAction
      Added value: +{
      +  "description": "FACEBOOK — a real call-to-action BUTTON on the Page post. The types that open a destination (SHOP_NOW, LEARN_MORE, SIGN_UP, BUY_NOW, DOWNLOAD, OPEN_LINK, WATCH_MORE, BOOK_TRAVEL) need somewhere to go: the post’s own `link`, or `callToActionLink`. CALL_NOW, MESSAGE_PAGE, LIKE_PAGE and GET_DIRECTIONS act on the Page itself and take none.",
      +  "enum": [
      +    "BOOK_TRAVEL",
      +    "BUY_NOW",
      +    "CALL_NOW",
      +    "DOWNLOAD",
      +    "GET_DIRECTIONS",
      +    "LEARN_MORE",
      +    "LIKE_PAGE",
      +    "MESSAGE_PAGE",
      +    "NO_BUTTON",
      +    "OPEN_LINK",
      +    "SHOP_NOW",
      +    "SIGN_UP",
      +    "WATCH_MORE"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / callToActionLink
      Added value: +{
      +  "description": "FACEBOOK — where the button goes, when that is not the post’s own `link`.",
      +  "type": "string"
      +}
    • addedInput schema / properties / coverUrl
      Added value: +{
      +  "description": "INSTAGRAM REEL COVER — a public image url Instagram fetches and uses as the cover in the Reels tab. REELS ONLY, and the alternative to `thumbOffset`: passing both is refused, since they are two answers to the same question. Run a local file through upload_file first.",
      +  "type": "string"
      +}
    • addedInput schema / properties / instagramLocationId
      Added value: +{
      +  "description": "INSTAGRAM — tag a place (called locationId on post_to_meta; locationId here is the Google Business listing). It is the NUMERIC ID OF A FACEBOOK PAGE associated with that location, not a place name and not coordinates; a non-numeric value is refused rather than sent.",
      +  "type": "string"
      +}
    • addedInput schema / properties / linkDescription
      Added value: +{
      +  "description": "FACEBOOK — override the DESCRIPTION of the link preview. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager ▸ Brand safety ▸ Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain.",
      +  "type": "string"
      +}
    • addedInput schema / properties / linkName
      Added value: +{
      +  "description": "FACEBOOK — override the HEADLINE of the link preview. Without it the post shows whatever Open Graph title the destination carries, which on a bare landing page is often nothing. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager ▸ Brand safety ▸ Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain.",
      +  "type": "string"
      +}
    • addedInput schema / properties / linkPicture
      Added value: +{
      +  "description": "FACEBOOK — override the IMAGE of the link preview: a public http(s) url Facebook fetches itself. Needs `link`. MEASURED 2026-09-17: Facebook only honours these when the Page’s business has VERIFIED the domain (Business Manager ▸ Brand safety ▸ Domains) — without that Meta refuses the post outright with “Only owners of the URL…”, so leave them out unless the brand owns and has verified that link’s domain.",
      +  "type": "string"
      +}
    • changedInput schema / properties / paidPartnership / description
      Previous value: -"X — label the post a PAID PARTNERSHIP. OPT-IN ONLY: set it when the post is sponsored, gifted or otherwise paid for, and never assume it on the user’s behalf."New value: +"INSTAGRAM AND X — the PAID PARTNERSHIP label, a compliance declaration: set it when the post is sponsored, gifted or otherwise paid for. OPT-IN ONLY, never assume it on the user’s behalf. On Instagram, brandedContentSponsorIds names the brands behind it."
    • addedInput schema / properties / place
      Added value: +{
      +  "description": "FACEBOOK — tag a location on the Page post. The NUMERIC ID OF THE FACEBOOK PAGE for that place, not a place name and not coordinates.",
      +  "type": "string"
      +}
    • addedInput schema / properties / shareToFeed
      Added value: +{
      +  "description": "INSTAGRAM REEL — true puts the Reel in the Feed grid as well as the Reels tab. REELS ONLY. Left unset it follows Instagram’s own default; Hermoso does not flip it either way on the user’s behalf.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / story
      Added value: +{
      +  "description": "INSTAGRAM STORY — publish this as a 24-hour Story instead of a feed post. One image OR one video: Instagram has no carousel story, so a carousel is REFUSED BY NAME rather than quietly posted to the feed. A Story carries NO CAPTION (there is nowhere to show one), no collaborators, no product tags and no trialReel — passing any of those is refused by name and nothing is posted, because a story that silently drops the words is worse than one that never went. INSTAGRAM ONLY: a Facebook Page story is a different upload and is not built, so a Facebook channel with `story` set is refused rather than published to the feed.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / targetAudience
      Added value: +{
      +  "description": "LINKEDIN COMPANY PAGE POST ONLY — show the post only to Page followers matching these facets (URNs or bare numeric ids; search_linkedin_ads_targeting finds them). LinkedIn requires the matching audience to be over 300 followers and refuses a smaller one. Personal-profile posts cannot be targeted.",
      +  "properties": {
      +    "degrees": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "fieldsOfStudy": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "geoLocations": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "industries": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "jobFunctions": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "organizations": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "seniorities": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "staffCountRanges": {
      +      "items": {
      +        "enum": [
      +          "SIZE_1",
      +          "SIZE_2_TO_10",
      +          "SIZE_11_TO_50",
      +          "SIZE_51_TO_200",
      +          "SIZE_201_TO_500",
      +          "SIZE_501_TO_1000",
      +          "SIZE_1001_TO_5000",
      +          "SIZE_5001_TO_10000",
      +          "SIZE_10001_OR_MORE"
      +        ],
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / thumbOffset
      Added value: +{
      +  "description": "INSTAGRAM REEL COVER, the other way — which frame becomes the cover, in MILLISECONDS from the start of the video. REELS ONLY. Use it instead of `coverUrl` when the right cover is already a frame of the clip.",
      +  "type": "number"
      +}
  17. Changed2 schema fields changedv0.1.243
    • changedInput schema / properties / description / description
      Previous value: -"YOUTUBE — the video DESCRIPTION, max 5000 characters: the box under the video carrying the links, the CTA and everything YouTube search reads. It is NOT the caption — a scheduled YouTube item’s text becomes its TITLE — so omitting this publishes the video with an empty description."New value: +"YOUTUBE: the video DESCRIPTION, max 5000 characters, carrying the links, the CTA and what YouTube search reads. Omit it and the caption is used."
    • addedInput schema / properties / thumbnailUrl
      Added value: +{
      +  "description": "YOUTUBE: the custom thumbnail, a Hermoso-hosted image (make_thumbnail, or upload_file for the user’s own). Omit it and a frame of the video is used; \"auto\" keeps YouTube’s pick.",
      +  "type": "string"
      +}
  18. Changed6 schema fields changedv0.1.230
    • changedInput schema / properties / communityId / description
      Previous value: -"X — publish into an X COMMUNITY instead of the main timeline: the number in the community’s own URL (x.com/i/communities/<id>). The connected account must be a MEMBER of it; X answers a non-member and a non-existent id with the same refusal and does not separate them."New value: +"X — publish into an X COMMUNITY instead of the main timeline: the number in the community’s own URL (x.com/i/communities/<id>). The connected account must be a MEMBER of it."
    • changedInput schema / properties / optimizeCopy / description
      Previous value: -"RECOMMENDED when one caption goes to several channels: fit the shared caption to each channel’s own rules when you schedule it (the fitted caption is stored on the scheduled post, so what you scheduled is what publishes) wherever no per-channel caption was written — YouTube gets a keyword title, a structured multi-paragraph description and search tags; Instagram/TikTok hashtags; LinkedIn longer; X/Bluesky short; Pinterest keyword-rich. The angle and every claim stay the author’s; a channel with its own caption is left exactly as written. Off by default so nobody’s words are rewritten unasked."New value: +"RECOMMENDED when one caption goes to several channels: fit the shared caption to each channel’s own rules when you schedule it (the fitted caption is stored on the scheduled post, so what you scheduled is what publishes) wherever no per-channel caption was written. The angle and every claim stay the author’s; a channel with its own caption is left exactly as written. Off by default so nobody’s words are rewritten unasked."
    • changedInput schema / properties / paidPartnership / description
      Previous value: -"X — label the post a PAID PARTNERSHIP, the same disclosure Hermoso already ships for TikTok. OPT-IN ONLY: set it when the post is sponsored, gifted or otherwise paid for, and never assume it on the user’s behalf."New value: +"X — label the post a PAID PARTNERSHIP. OPT-IN ONLY: set it when the post is sponsored, gifted or otherwise paid for, and never assume it on the user’s behalf."
    • changedInput schema / properties / thread / description
      Previous value: -"X — publish a THREAD, one entry per post, each replying to the one before (at most 25). 280 characters per part without X Premium, up to 25,000 with it — nothing is truncated, and on a Premium account one long post is usually better AND cheaper than a thread. It REPLACES the X caption: with a thread set, `message`/`captions.x` is not sent to X at all. A thread cannot carry a poll."New value: +"X — publish a THREAD, one entry per post, each replying to the one before (at most 25). 280 characters per part without X Premium, up to 25,000 with it; nothing is truncated. It REPLACES the X caption: with a thread set, `message`/`captions.x` is not sent to X at all. A thread cannot carry a poll."
    • addedInput schema / properties / xArticle
      Added value: +{
      +  "description": "X: publish the X item as a long-form X ARTICLE. title is its headline, the X text (message or captions.x) its markdown body, the image its cover. Refused now if the markdown has formatting X cannot hold. X allows about 5 Articles a day; one that fires into that cap fails with the reset time and can be retried.",
      +  "properties": {
      +    "headings": {
      +      "enum": [
      +        "blocks",
      +        "text"
      +      ],
      +      "type": "string"
      +    },
      +    "title": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / xQuotePostId / description
      Previous value: -"X — the numeric id of an X post this one QUOTES: the last part of its URL. X renders that post inside yours and it stands alone on your own timeline, which is what makes a quote different from a reply. NAMED xQuotePostId, NOT quotePostId, because `quotePostId` on this same schedule belongs to THREADS — a schedule going to both channels would otherwise be silently ambiguous. Billed at X’s higher LINK rate, because X appends the quoted post’s t.co URL to yours."New value: +"X — the numeric id of an X post this one QUOTES: the last part of its URL. NAMED xQuotePostId, NOT quotePostId, because `quotePostId` on this same schedule belongs to THREADS. Billed at X’s higher LINK rate."
  19. Changed1 schema field changedv0.1.225
    • changedInput schema / properties / optimizeCopy / description
      Previous value: -"RECOMMENDED when one caption goes to several channels: fit the shared caption to each channel’s own rules at publish time wherever no per-channel caption was written — YouTube gets a keyword title, a structured multi-paragraph description and search tags; Instagram/TikTok hashtags; LinkedIn longer; X/Bluesky short; Pinterest keyword-rich. The angle and every claim stay the author’s; a channel with its own caption is left exactly as written. Off by default so nobody’s words are rewritten unasked."New value: +"RECOMMENDED when one caption goes to several channels: fit the shared caption to each channel’s own rules when you schedule it (the fitted caption is stored on the scheduled post, so what you scheduled is what publishes) wherever no per-channel caption was written — YouTube gets a keyword title, a structured multi-paragraph description and search tags; Instagram/TikTok hashtags; LinkedIn longer; X/Bluesky short; Pinterest keyword-rich. The angle and every claim stay the author’s; a channel with its own caption is left exactly as written. Off by default so nobody’s words are rewritten unasked."
  20. Changed1 schema field changedv0.1.217
    • changedInput schema / properties / trialReel / description
      Previous value: -"INSTAGRAM TRIAL REEL — publish this Reel to NON-FOLLOWERS ONLY at first, so a hook can be tested on a cold audience without spending it on the people who already follow the brand; Instagram shows it to followers only if it graduates. MANUAL = the creator graduates it by hand in the Instagram app; SS_PERFORMANCE = Instagram graduates it automatically if it performs. REELS ONLY and INSTAGRAM ONLY: an image, a carousel, or a Facebook/Threads channel is REFUSED BY NAME rather than quietly published as an ordinary post — a trial that silently goes to every follower is the exact opposite of what was asked for, so Instagram must be one of the `channels` and the item must carry a video. Omit it for a normal Reel."New value: +"INSTAGRAM TRIAL REEL — publish this Reel to NON-FOLLOWERS ONLY at first (Instagram allows trials only on accounts above its follower threshold — about 1,000 followers; an ineligible account is refused by name and nothing is posted), so a hook can be tested on a cold audience without spending it on the people who already follow the brand; Instagram shows it to followers only if it graduates. MANUAL = the creator graduates it by hand in the Instagram app; SS_PERFORMANCE = Instagram graduates it automatically if it performs. REELS ONLY and INSTAGRAM ONLY: an image, a carousel, or a Facebook/Threads channel is REFUSED BY NAME rather than quietly published as an ordinary post — a trial that silently goes to every follower is the exact opposite of what was asked for, so Instagram must be one of the `channels` and the item must carry a video. Omit it for a normal Reel."
  21. Changed2 schema fields changedv0.1.209
    • addedInput schema / properties / aiGenerated
      Added value: +{
      +  "description": "INSTAGRAM / FACEBOOK REEL — Meta’s is_ai_generated self-disclosure. OMIT IT and Hermoso decides from provenance: a Hermoso render is declared, media that came through upload_file or from an external URL (the user’s own photographs or footage) is NOT — a real photo must never carry Instagram’s “AI info” label. Pass true or false only to override: false strips the label from something Hermoso would otherwise declare, true declares a render the user uploaded themselves.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / optimizeCopy
      Added value: +{
      +  "description": "RECOMMENDED when one caption goes to several channels: fit the shared caption to each channel’s own rules at publish time wherever no per-channel caption was written — YouTube gets a keyword title, a structured multi-paragraph description and search tags; Instagram/TikTok hashtags; LinkedIn longer; X/Bluesky short; Pinterest keyword-rich. The angle and every claim stay the author’s; a channel with its own caption is left exactly as written. Off by default so nobody’s words are rewritten unasked.",
      +  "type": "boolean"
      +}
  22. Changed1 schema field changedv0.1.189
    • addedInput schema / properties / accounts
      Added value: +{
      +  "additionalProperties": {
      +    "anyOf": [
      +      {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "const": "all",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  "description": "WHICH accounts of a multi-account channel to post to, e.g. { \"tiktok\": [\"@a\", \"@b\"] } or { \"tiktok\": \"all\" } — one row per account at fire time, each with its own result. Omit for channels with one account (several and none named is refused by name).",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  23. Addedv0.1.161

TDQS

A4.2/5.0
Behavior5/5

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

Goes far beyond the annotations (destructiveHint/openWorldHint/idempotentHint) by disclosing credit cost, the free-plan 5-posts/3-channels limit and UTC-month counting, that over-limit posts are refused with nothing queued, that posts go live publicly by default, and that Pinterest/Facebook/LinkedIn multi-account targets are refused at scheduling rather than guessed. These are real operational behaviours an agent must know before calling a 129-parameter mutation.

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-loads purpose, cost, and plan limits before channel-specific requirements, which is the right order. Every sentence carries an operational fact, but the ALL-CAPS density and run-on clauses make it heavier to parse than needed even for a tool this large.

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

Completeness4/5

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

For a 129-parameter, 18-channel, no-output-schema tool, it covers the decision-critical pieces: cost, quota, refusal semantics, default visibility, and the required per-channel ids, and it delegates the exhaustive rulebook to get_instructions({topic:'schedule_post'}). Return shape is not described, but the schema repeatedly refers to per-channel result rows, which covers most of the gap.

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. The description still adds selection meaning: imageUrls[] as an ordered CAROUSEL (never just slide 1), at vs useQueue mutual exclusion and the "just queue it" phrasing, and which channel-specific ids must come from which list_* tool. That is genuine routing value on top of the schema.

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

Purpose4/5

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

Opens with a specific verb+resource+timing: "schedule a social media post for later, on one channel or several." That distinguishes it from the immediate-publish post_to_* siblings by scope, though it never names one of them explicitly. An agent can tell what it does without opening the schema.

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

Usage Guidelines4/5

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

Gives concrete when-to-use context (schedule for later, single or multi-channel, queue vs explicit time), plus prerequisites that must be resolved first (boardId via list_pinterest_boards, linkedinOrganizationId via list_linkedin_pages, pageId via list_meta_pages). It excludes retry/split behaviour on plan-limit refusal and points to get_instructions for full rules. It doesn't explicitly contrast with the immediate-post siblings, so just short of a 5.

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

Deploy Server

Other Tools