postIdstringobligatoire
Post id (from list_posts or get_post).
namestringfacultatif
Internal post name/label. Required, non-empty, ≤255 characters.
postType"announcement" | "event" | "offer"facultatif
Post type. `announcement` is supported by all platforms. `event` and `offer` are GOOGLE-ONLY — if any social platform (facebook, instagram, x, linkedin, pinterest, mastodon, bluesky) is selected, postType must be `announcement`.
platforms("google" | "facebook" | "instagram" | "x" | "linkedin" | "pinterest" | "mastodon" | "bluesky" | "threads" | "tiktok")[]facultatif
Target platforms. Valid values: google, facebook, instagram, x, linkedin, pinterest, mastodon, bluesky. At least one is required; unknown values are rejected. e.g. ["google","facebook","instagram"].
messageGooglestringfacultatif
Caption for Google. Required when `google` is selected (unless draft). Max 1500 characters.
messageFacebookstringfacultatif
Shared social caption — used by facebook, instagram, x, linkedin, pinterest, mastodon, bluesky. Required when any of those is selected, unless draft. It is validated against EACH selected platform's character limit: facebook 30000, instagram 2200, x 280 (X thread mode is exempt from the 280 limit), linkedin 2000, pinterest 500, mastodon 500, bluesky 300. The message must fit the smallest limit among the selected social platforms.
ctaType"learn_more" | "sign_up" | "order_online" | "book" | "buy" | "call_now"facultatif
Call-to-action type. For a Google `offer`, ctaType AND ctaUrl are both required. learn_more/sign_up/order_online/book/buy all require ctaUrl; call_now does not.
ctaUrlstringfacultatif
Call-to-action URL. Required for a Google offer and for CTA types other than call_now.
mediaUrlsobject[]facultatif
Media items, one entry per platform attachment: [{ "url", "platform", "type": "image"|"video" }]. The `platform` on each item must be one of the target platforms and controls which per-platform media rules apply. Per-platform limits (violations are rejected): google = no media constraints enforced here; facebook = ≤10 images OR ≤1 video, no mix (carousel: 2–10 image cards, images only); instagram = requires ≥1 item, ≤10 images OR ≤1 video, images and video cannot be mixed; x = ≤4 images OR ≤1 video, no mix; linkedin = ≤5 images OR ≤1 video, no mix; pinterest = image only (no video), exactly 1 image, required; mastodon = ≤4 images OR ≤1 video, no mix.
urlstringfacultatif
Publicly reachable media URL (http/https).
platform"google" | "facebook" | "instagram" | "x" | "linkedin" | "pinterest" | "mastodon" | "bluesky"facultatif
Which target platform this media attaches to.
type"image" | "video"facultatif
Media kind.
eventTitlestringfacultatif
Event/offer title. For a Google event or offer this is required (unless draft) and must be ≤58 characters.
eventStartAtstringfacultatif
Event/offer start (ISO timestamp). Required for Google event/offer posts (unless draft).
eventEndAtstringfacultatif
Event/offer end (ISO timestamp). Required for Google event/offer posts (unless draft); must be after the start.
offerTermsstringfacultatif
Offer terms (offer posts).
offerCouponCodestringfacultatif
Offer coupon code.
offerRedeemUrlstringfacultatif
Offer redemption URL.
scheduledForstringfacultatif
Schedule for this ISO timestamp (must be in the future; omit to publish now).
draftbooleanfacultatif
Save as draft without publishing. Drafts skip publish-gating 'required' checks (required message, required media, required event/offer fields) but STILL enforce structural checks: character limits, media counts, media mixing, valid enums, carousel bounds, and date ordering.