Skip to content

Edit Scheduled Post API

The Edit Scheduled Post API replaces the editable fields of an existing scheduled post, including its content, media, target platforms, and scheduled time. This endpoint is deprecated in favor of PUT /v1/posts/:postId, but its exact contract is preserved here for parity: PUT /v1/posts/scheduled/{postId}. The request requires content and platforms, while scheduledFor and timezone are optional and, when omitted, keep the current scheduled time and timezone. The operation also reconciles credits, with no amounts, windows, or rules specified in the preserved contract.

Edit Scheduled Post API — deprecated status and exact endpoint

This endpoint is deprecated. The named replacement is PUT /v1/posts/:postId. The preserved contract for this page remains PUT /v1/posts/scheduled/{postId}, and it replaces the editable fields of a scheduled post and reconciles credits. Use the postId of the scheduled post you want to edit as the path parameter. Because content and platforms are required, an edit request must supply the full replacement text and the full replacement target list, not only the fields that changed. Optional fields control whether the schedule changes: omit scheduledFor to keep the current scheduled time, and omit timezone to keep the current timezone. Before sending, check that postId is the scheduled post identifier, that content is a string, and that platforms contains at least one target object with a platform value and an accountId.

Authorization and path parameter

Send the access key in the x-access-key header. The Authorization section names accessKey, the header name x-access-key, and the value placeholder <token>. The path parameter postId is a required string. The preserved contract specifies x-access-key as the header name, so use that name rather than a different header name. Keep the path exactly as /v1/posts/scheduled/{postId} with the method PUT, and substitute only the postId value and the origin placeholder {{API_BASE_URL}} in examples.

Request body field map

The request body is application/json. The required content field is a string containing the new post text body. The required platforms field is an array of objects with at least one item, representing the replacement target platform accounts to publish to. The optional mediaItems field is an array of objects representing replacement media attachments for images, videos, and GIFs; each item requires type and url, where type is one of image, video, gif, or document, and url is a URI. Optional altText on a media item is a string from 1 to 1000 characters, and optional thumbnail is a URI. The optional scheduledFor field is a string in ISO 8601 date-time format; omit it to keep the current scheduled time. The optional timezone field is a string naming an IANA timezone for the scheduled time; omit it to keep the current one. A common failure check is sending an empty platforms array, which violates the 1 <= items constraint, or sending scheduledFor in a non-date-time format. See the request body field map table for the complete field list.

Platform-specific replacement data

Each platforms item requires platform and accountId, and may include an optional per-platform content override and optional platformSpecificData. When the per-platform content is omitted, the top-level content is used. The accountId is the integration identifier, described as Integration._id and found via GET /connect/integrations. The platform value selects which platformSpecificData shape applies. For twitter, platformSpecificData may include communityId, shareWithFollowers, replyToTweetId, replySettings with values following, mentionedUsers, subscribers, or verified, threadItems, longPost, and poll. For instagram, it may include locationId, audioConfiguration, contentType story, isAiGenerated, shareToFeed, trialParams, coverUrl, thumbOffset, audioName, and collaborators. For youtube, it may include title, tags, visibility public, private, or unlisted, madeForKids, containsSyntheticMedia, categoryId, playlistId, and firstComment. For tiktok, it may include privacyLevel, disableComment, disableDuet, disableStitch, brandContentToggle, brandOrganicToggle, isAigc, videoCoverTimestampMs, autoAddMusic, photoCoverIndex, description, and draft. For pinterest, platformSpecificData requires boardId and may include title, link, altText, dominantColor, and coverImageUrl. For linkedin, it may include visibility PUBLIC or CONNECTIONS, mentions, articleUrl, articleTitle, articleDescription, and documentTitle. For bluesky, it may include langs and altText. For facebook, it may include contentType reel or story, link, isAiGenerated, published, and videoThumbnailUrl. For threads, it may include replyControl everyone, accounts_you_follow, or mentioned_only, and altText. For googlebusiness, it may include topicType STANDARD, EVENT, or OFFER, callToActionType, callToActionUrl, event fields, and offer fields. When replacing platforms, include the complete new target list and the platformSpecificData for each target in the same request, then verify the response postId matches the edited scheduled post.

Response body and status codes

A 200 response returns success as a required boolean, message as an optional string, postId as a required string, and scheduledFor as an optional date-time string. The 400, 402, 403, 404, 409, and 503 responses are each shown with the same generic shape of success and message, with success as a required boolean and message as a required string in the error contract. Do not infer specific error codes or meanings beyond the status and shape supplied. After a successful edit, compare the returned postId with the path postId and check scheduledFor when you changed the schedule. If you omitted scheduledFor, the current scheduled time is kept, so do not expect the response to prove a new time was set. See the response status map table and the request and response examples below for the exact origin-modular sample and the preserved response shapes.

Request body field map
FieldRequiredTypeConstraints and semantics
contentRequiredstringNew post text body
mediaItemsOptionalarray<object>Replacement media attachments (images, videos, GIFs)
mediaItems[].typeRequiredstring"image" | "video" | "gif" | "document"
mediaItems[].urlRequiredstringFormat: uri
mediaItems[].altTextOptionalstring1 <= length <= 1000
mediaItems[].thumbnailOptionalstringFormat: uri
platformsRequiredarray<object>1 <= items; replacement target platform accounts to publish to
platforms[].platformRequiredstringPer-variant enum, for example "twitter"
platforms[].accountIdRequiredstringIntegration._id — find yours via GET /connect/integrations
platforms[].contentOptionalstringPer-platform text override; top-level content is used when omitted
platforms[].platformSpecificDataOptionalobjectPer-platform options for the selected platform variant
scheduledForOptionalstringFormat: date-time; omit to keep the current scheduled time
timezoneOptionalstringIANA timezone for the scheduled time; omit to keep the current one

Preserved source contract; omit scheduledFor to keep current time and omit timezone to keep current timezone.

Response status map
StatussuccessmessagepostIdscheduledFor
200Required booleanOptional stringRequired stringOptional string, format: date-time
400Required booleanRequired stringNot in supplied error shapeNot in supplied error shape
402Required booleanRequired stringNot in supplied error shapeNot in supplied error shape
403Required booleanRequired stringNot in supplied error shapeNot in supplied error shape
404Required booleanRequired stringNot in supplied error shapeNot in supplied error shape
409Required booleanRequired stringNot in supplied error shapeNot in supplied error shape
503Required booleanRequired stringNot in supplied error shapeNot in supplied error shape

Error meanings are not supplied in the source and are not invented here.

Edit a scheduled post request example
curl -X PUT "{{API_BASE_URL}}/v1/posts/scheduled/string" \
  -H "Content-Type: application/json" \
  -H "x-access-key: <token>" \
  -d '{
    "content": "string",
    "platforms": [
      {
        "platform": "twitter",
        "accountId": "string"
      }
    ]
  }'
200 response example
{
  "success": true,
  "message": "string",
  "postId": "string",
  "scheduledFor": "2019-08-24T14:15:22Z"
}
Error response shape as supplied for 400, 402, 403, 404, 409 and 503
{
  "success": true,
  "message": "string"
}
Interface fields
ScopeFieldTypeType referenceRequiredDescriptionConstraints
body#1bodyobject__0Yes
body#1body.contentstring__1YesNew post text body
body#1body.mediaItemsarray<object>__2NoReplacement media attachments (images, videos, GIFs)
body#1body.mediaItems[]object__3
body#1body.mediaItems[].typestring__4Yeskind: schemaValueIn; value: "image" | "video" | "gif" | "document"
body#1body.mediaItems[].urlstring__5YesPublicly accessible URL for the media file. the service or the platform provider must be able to fetch it without authentication.kind: schemaFormat; value: uri
body#1body.mediaItems[].altTextstring__6NoAccessibility description for an image. Supported platforms forward it when publishing images; unsupported platforms and non-image media ignore it.kind: schemaLength; value: 1 <= length <= 1000
body#1body.mediaItems[].thumbnailstring__7NoThumbnail image URL for Facebook videos and YouTube regular videos (not Shorts). YouTube accepts JPEG, PNG, or GIF, max 2 MB, min 640 px wide.kind: schemaFormat; value: uri
body#1body.platformsarray<object>__8YesReplacement target platform accounts to publish tokind: schemaItems; value: 1 <= items
body#1body.platforms[]object__9
body#1body.platforms[][variant1]object__9_extends:__10
body#1body.platforms[][variant1].platformstring__11Yeskind: schemaValueIn; value: "twitter"
body#1body.platforms[][variant1].accountIdstring__12YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant1].contentstring__13NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant1].platformSpecificDataobject#/components/schemas/TwitterConfigurationsNoPass this object in platformSpecificData when posting to Twitter/X, including Community post options.
body#1body.platforms[][variant1].platformSpecificData.communityIdstring__14NoCommunity ID to publish this post into.
body#1body.platforms[][variant1].platformSpecificData.shareWithFollowersboolean__15NoWhen posting to a Community, also share the post with followers.
body#1body.platforms[][variant1].platformSpecificData.replyToTweetIdstring__16NoTweet ID to reply to.
body#1body.platforms[][variant1].platformSpecificData.replySettingsstring__17Nokind: schemaValueIn; value: "following" | "mentionedUsers" | "subscribers" | "verified"
body#1body.platforms[][variant1].platformSpecificData.threadItemsarray<object>__18NoAdditional tweets to chain as a thread. The root tweet uses post.content.
body#1body.platforms[][variant1].platformSpecificData.threadItems[]object__19
body#1body.platforms[][variant1].platformSpecificData.threadItems[].contentstring__20YesText of this thread tweet (max 280 chars)
body#1body.platforms[][variant1].platformSpecificData.threadItems[].mediaItemsarray<object>__21No
body#1body.platforms[][variant1].platformSpecificData.threadItems[].mediaItems[]object__22
body#1body.platforms[][variant1].platformSpecificData.threadItems[].mediaItems[].typestring__23Yeskind: ; value: "image" | "video" | "gif" | "document"
body#1body.platforms[][variant1].platformSpecificData.threadItems[].mediaItems[].urlstring__24YesPublicly accessible URL for the media file. the service or the platform provider must be able to fetch it without authentication.kind: ; value: uri
body#1body.platforms[][variant1].platformSpecificData.threadItems[].mediaItems[].altTextstring__25NoAccessibility description for an image. Supported platforms forward it when publishing images; unsupported platforms and non-image media ignore it.kind: ; value: 1 <= length <= 1000
body#1body.platforms[][variant1].platformSpecificData.threadItems[].mediaItems[].thumbnailstring__26NoThumbnail image URL for Facebook videos and YouTube regular videos (not Shorts). YouTube accepts JPEG, PNG, or GIF, max 2 MB, min 640 px wide.kind: ; value: uri
body#1body.platforms[][variant1].platformSpecificData.longPostboolean__27NoOpt in to long posts (over 280 characters). Skips the service's 280-character pre-check so X can accept up to 25,000 characters for eligible Premium / Premium+ accounts. If the connected account is not eligible, X rejects the post and the error is surfaced back. No extra API cost.
body#1body.platforms[][variant1].platformSpecificData.pollobject__28NoCannot be combined with media or threadItems.
body#1body.platforms[][variant1].platformSpecificData.poll.optionsarray<string>__29Yes2–4 poll options.kind: ; value: 2 <= items <= 4
body#1body.platforms[][variant1].platformSpecificData.poll.options[]string__30
body#1body.platforms[][variant1].platformSpecificData.poll.durationMinutesnumber__31YesPoll duration in minutes (5 min – 7 days).kind: ; value: 5 <= value <= 10080
body#1body.platforms[][variant2]object__9_extends:__32
body#1body.platforms[][variant2].platformstring__33Yeskind: ; value: "instagram"
body#1body.platforms[][variant2].accountIdstring__34YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant2].contentstring__35NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant2].platformSpecificDataobject#/components/schemas/InstagramConfigurationsNoPass this object in platformSpecificData when posting to Instagram. Use contentType to publish Stories; the remaining fields customize feed posts and Reels.
body#1body.platforms[][variant2].platformSpecificData.locationIdstring__36NoNumeric Facebook Page ID with location data. Feed posts, Reels and whole carousels only; not Stories.kind: ; value: ^\d+$
body#1body.platforms[][variant2].platformSpecificData.audioConfigurationobject__37NoCatalog audio for single-video Reels, requires Facebook Login. Volumes default to 100. Audio must remain available at publish time.
body#1body.platforms[][variant2].platformSpecificData.audioConfiguration.audioIdstring__38Yeskind: ; value: ^\d+$
body#1body.platforms[][variant2].platformSpecificData.audioConfiguration.audioVolumeinteger__39Nokind: ; value: 1 <= value <= 100
body#1body.platforms[][variant2].platformSpecificData.audioConfiguration.videoVolumeinteger__40Nokind: ; value: 1 <= value <= 100
body#1body.platforms[][variant2].platformSpecificData.contentTypestring__41NoSet to "story" to publish an Instagram Story. Omit for the existing behavior: images publish to Feed and videos publish as Reels.kind: ; value: "story"
body#1body.platforms[][variant2].platformSpecificData.isAiGeneratedboolean__42NoSelf-discloses that the post contains AI-generated images or video so Instagram can show its AI info label. Applies to feed posts, Reels, Stories, and carousel parents; it does not describe AI-written captions.
body#1body.platforms[][variant2].platformSpecificData.shareToFeedboolean__43NoReels-only. When true (default), the Reel also appears in the account's main feed grid. Set false to publish to Reels only.
body#1body.platforms[][variant2].platformSpecificData.trialParamsobject__44NoReels-only. Publishes a single video as a Trial Reel, initially shown to non-followers.
body#1body.platforms[][variant2].platformSpecificData.trialParams.graduationStrategystring__45YesControls how a Trial Reel is shared with followers. MANUAL keeps graduation manual; SS_PERFORMANCE lets Instagram share it automatically when it performs well.kind: ; value: "MANUAL" | "SS_PERFORMANCE"
body#1body.platforms[][variant2].platformSpecificData.coverUrlstring__46NoVideo-only. Public URL of an image Instagram will use as the cover frame for the Reel/video post. Ignored for image posts.kind: ; value: uri
body#1body.platforms[][variant2].platformSpecificData.thumbOffsetinteger__47NoVideo-only. Timestamp in milliseconds Instagram extracts as the cover frame. Ignored when coverUrl is set or for image posts.kind: ; value: 0 <= value
body#1body.platforms[][variant2].platformSpecificData.audioNamestring__48NoReels-only. Sets the name shown for the Reel audio. This only labels audio already in the video file. Use audioConfiguration to attach catalog audio through Facebook Login.kind: ; value: 1 <= length <= 100
body#1body.platforms[][variant2].platformSpecificData.collaboratorsarray<string>__49NoFeed posts, carousels, and Reels only. Up to three Instagram usernames to invite as collaborators. Each account must accept the invitation in Instagram.kind: ; value: 1 <= items <= 3
body#1body.platforms[][variant2].platformSpecificData.collaborators[]string__50Instagram username without the leading @.kind: ; value: ^[A-Za-z0-9._]+$ | kind: ; value: 1 <= length <= 30
body#1body.platforms[][variant3]object__9_extends:__51
body#1body.platforms[][variant3].platformstring__52Yeskind: ; value: "youtube"
body#1body.platforms[][variant3].accountIdstring__53YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant3].contentstring__54NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant3].platformSpecificDataobject#/components/schemas/YouTubeConfigurationsNoPass this object in platformSpecificData when posting to YouTube.
body#1body.platforms[][variant3].platformSpecificData.titlestring__55NoVideo title (max 100 chars, no < or >). Defaults to first 100 chars of content, or "Untitled Video".kind: ; value: length <= 100
body#1body.platforms[][variant3].platformSpecificData.tagsarray<string>__56NoVideo tags. Total characters across all tags must be ≤500.
body#1body.platforms[][variant3].platformSpecificData.tags[]string__57
body#1body.platforms[][variant3].platformSpecificData.visibilitystring__58NoWho can see the video. Defaults to "public". Scheduled posts remain queued in the service and upload at the scheduled time using this visibility.kind: ; value: "public" | "private" | "unlisted"
body#1body.platforms[][variant3].platformSpecificData.madeForKidsboolean__59NoCOPPA compliance flag. Setting to true permanently disables comments, notification bell, personalized ads, end screens, and cards on the video. Defaults to false.
body#1body.platforms[][variant3].platformSpecificData.containsSyntheticMediaboolean__60NoAI-generated content disclosure. YouTube is increasingly enforcing this requirement. Defaults to false.
body#1body.platforms[][variant3].platformSpecificData.categoryIdstring__61NoYouTube category ID. Defaults to "22" (People & Blogs). Common values: "1" Film & Animation, "10" Music, "20" Gaming, "22" People & Blogs, "27" Education, "28" Science & Technology.
body#1body.platforms[][variant3].platformSpecificData.playlistIdstring__62NoPlaylist to add the uploaded video to. Retrieve available IDs from the YouTube playlists endpoint.kind: ; value: 1 <= length
body#1body.platforms[][variant3].platformSpecificData.firstCommentstring__63NoAuto-posted comment after upload. Max 10,000 characters. For publishNow posts: posted immediately after upload. For scheduled posts: posted after the upload at the scheduled time.kind: ; value: length <= 10000
body#1body.platforms[][variant4]object__9_extends:__64
body#1body.platforms[][variant4].platformstring__65Yeskind: ; value: "tiktok"
body#1body.platforms[][variant4].accountIdstring__66YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant4].contentstring__67NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant4].platformSpecificDataobject#/components/schemas/TikTokConfigurationsNoPass this object in platformSpecificData when posting to TikTok.
body#1body.platforms[][variant4].platformSpecificData.privacyLevelstring__68NoWho can see this post. Defaults to "PUBLIC_TO_EVERYONE".kind: ; value: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY"
body#1body.platforms[][variant4].platformSpecificData.disableCommentboolean__69NoDisable comments on this post. Defaults to false.
body#1body.platforms[][variant4].platformSpecificData.disableDuetboolean__70NoDisable duet for this video. Videos only. Defaults to false.
body#1body.platforms[][variant4].platformSpecificData.disableStitchboolean__71NoDisable stitch for this video. Videos only. Defaults to false.
body#1body.platforms[][variant4].platformSpecificData.brandContentToggleboolean__72NoMark as branded content (paid partnership). Defaults to false.
body#1body.platforms[][variant4].platformSpecificData.brandOrganicToggleboolean__73NoMark as organic brand promotion. Defaults to false.
body#1body.platforms[][variant4].platformSpecificData.isAigcboolean__74NoAI-generated content disclosure for photo and video posts. Defaults to false.
body#1body.platforms[][variant4].platformSpecificData.videoCoverTimestampMsnumber__75NoTimestamp in milliseconds to use as the video cover frame. Videos only.kind: ; value: 0 <= value
body#1body.platforms[][variant4].platformSpecificData.autoAddMusicboolean__76NoAutomatically add background music to photo carousels. Photo posts only. Defaults to true.
body#1body.platforms[][variant4].platformSpecificData.photoCoverIndexnumber__77No0-indexed position of the cover image in a photo carousel. Photo posts only. Defaults to 0.kind: ; value: 0 <= value
body#1body.platforms[][variant4].platformSpecificData.descriptionstring__78NoSeparate description for a TikTok photo or carousel post. Max 4,000 characters. When omitted, the post content is also used as the description. Photo posts only.kind: ; value: length <= 4000
body#1body.platforms[][variant4].platformSpecificData.draftboolean__79NoWhen true, sends content to the creator's TikTok inbox as a draft. Defaults to false (publishes immediately via DIRECT_POST).
body#1body.platforms[][variant5]object__9_extends:__80
body#1body.platforms[][variant5].platformstring__81Yeskind: ; value: "pinterest"
body#1body.platforms[][variant5].accountIdstring__82YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant5].contentstring__83NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant5].platformSpecificDataobject#/components/schemas/PinterestConfigurationsNoPass this object in platformSpecificData when posting to Pinterest.
body#1body.platforms[][variant5].platformSpecificData.boardIdstring__84YesTarget board ID. Retrieve available boards via GET /v1/pinterest/boards.
body#1body.platforms[][variant5].platformSpecificData.titlestring__85NoPin title. Max 100 characters. Defaults to first line of content.kind: ; value: length <= 100
body#1body.platforms[][variant5].platformSpecificData.linkstring__86NoHTTPS destination URL when the pin is clicked. Important for driving traffic.kind: ; value: uri
body#1body.platforms[][variant5].platformSpecificData.altTextstring__87NoAccessible image description. Max 500 characters.kind: ; value: length <= 500
body#1body.platforms[][variant5].platformSpecificData.dominantColorstring__88NoHex color for the loading placeholder (e.g. "#6E7874").
body#1body.platforms[][variant5].platformSpecificData.coverImageUrlstring__89NoCustom cover image URL for video pins.kind: ; value: uri
body#1body.platforms[][variant6]object__9_extends:__90
body#1body.platforms[][variant6].platformstring__91Yeskind: ; value: "linkedin"
body#1body.platforms[][variant6].accountIdstring__92YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant6].contentstring__93NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant6].platformSpecificDataobject#/components/schemas/LinkedInConfigurationsNoPass this object in platformSpecificData when posting to LinkedIn.
body#1body.platforms[][variant6].platformSpecificData.visibilitystring__94NoPost visibility. "PUBLIC" = visible to everyone, "CONNECTIONS" = visible to connections only. Defaults to "PUBLIC".kind: ; value: "PUBLIC" | "CONNECTIONS"
body#1body.platforms[][variant6].platformSpecificData.mentionsarray<object>__95NoTag company pages in the post text. Each entry maps an exact substring of content to the organization URN to mention; LinkedIn renders it as a clickable @mention. Only company pages can be mentioned, not personal profiles.kind: ; value: items <= 30
body#1body.platforms[][variant6].platformSpecificData.mentions[]object__96
body#1body.platforms[][variant6].platformSpecificData.mentions[].textstring__97YesExact substring within the post content to turn into a clickable mention (e.g. "Acme Corp"). Case-sensitive, must appear exactly once in content.kind: ; value: 1 <= length
body#1body.platforms[][variant6].platformSpecificData.mentions[].urnstring__98YesLinkedIn URN of the company page to mention, e.g. "urn:li:organization:12345". LinkedIn's API only supports mentioning organization/company pages, not personal profiles.kind: ; value: ^urn:li:organization:.+$
body#1body.platforms[][variant6].platformSpecificData.articleUrlstring__99NoURL for an article/link post. When provided, the post becomes a link share with a preview card.kind: ; value: uri
body#1body.platforms[][variant6].platformSpecificData.articleTitlestring__100NoTitle for the article preview card. Max 400 characters.kind: ; value: length <= 400
body#1body.platforms[][variant6].platformSpecificData.articleDescriptionstring__101NoDescription for the article preview card. Max 400 characters.kind: ; value: length <= 400
body#1body.platforms[][variant6].platformSpecificData.documentTitlestring__102NoTitle shown on the document card when posting a PDF. Required by LinkedIn when a document media item is included.kind: ; value: length <= 200
body#1body.platforms[][variant7]object__9_extends:__103
body#1body.platforms[][variant7].platformstring__104Yeskind: ; value: "bluesky"
body#1body.platforms[][variant7].accountIdstring__105YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant7].contentstring__106NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant7].platformSpecificDataobject#/components/schemas/BlueskyConfigurationsNoPass this object in platformSpecificData when posting to Bluesky.
body#1body.platforms[][variant7].platformSpecificData.langsarray<string>__107NoBCP-47 language tags for the post (e.g. ["en"], ["en-US", "es"]). Defaults to ["en"].
body#1body.platforms[][variant7].platformSpecificData.langs[]string__108
body#1body.platforms[][variant7].platformSpecificData.altTextarray<string>__109NoAlt text for each image, in the same order as mediaItems. Strongly encouraged for accessibility.
body#1body.platforms[][variant7].platformSpecificData.altText[]string__110
body#1body.platforms[][variant8]object__9_extends:__111
body#1body.platforms[][variant8].platformstring__112Yeskind: ; value: "facebook"
body#1body.platforms[][variant8].accountIdstring__113YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant8].contentstring__114NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant8].platformSpecificDataobject#/components/schemas/FacebookConfigurationsNoPass this object in platformSpecificData when posting to Facebook Pages.
body#1body.platforms[][variant8].platformSpecificData.contentTypestring__115NoSet to "reel" to publish exactly one video as a Facebook Page Reel, or "story" to publish exactly one image or video as a Story. Omit for a feed post. Stories expire after 24 hours; captions, links, and custom thumbnails are ignored. published: false is not supported for Stories.kind: ; value: "reel" | "story"
body#1body.platforms[][variant8].platformSpecificData.linkstring__116NoWhen provided on a text-only post, Facebook renders a link preview card from this URL's Open Graph tags. Ignored when mediaItems are attached.kind: ; value: uri
body#1body.platforms[][variant8].platformSpecificData.isAiGeneratedboolean__117NoSelf-discloses that the uploaded video is AI-generated. Supported for Facebook Page feed videos, Reels, and video Stories; it is not applied to text, photo, or carousel posts.
body#1body.platforms[][variant8].platformSpecificData.publishedboolean__118NoWhen false, the post is created on the Page in unpublished/draft state — useful for staging or scheduling via Facebook's own composer. Defaults to true.
body#1body.platforms[][variant8].platformSpecificData.videoThumbnailUrlstring__119NoVideo posts only. Optional Facebook-specific override for mediaItems[].thumbnail. Applied as a follow-up call after publish — if the upload fails, the post still succeeds (Facebook just auto-picks a frame). Ignored when no video is attached.kind: ; value: uri
body#1body.platforms[][variant9]object__9_extends:__120
body#1body.platforms[][variant9].platformstring__121Yeskind: ; value: "threads"
body#1body.platforms[][variant9].accountIdstring__122YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant9].contentstring__123NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant9].platformSpecificDataobject#/components/schemas/ThreadsConfigurationsNoPass this object in platformSpecificData when posting to Threads.
body#1body.platforms[][variant9].platformSpecificData.replyControlstring__124NoWho can reply to this thread. Defaults to "everyone" when omitted.kind: ; value: "everyone" | "accounts_you_follow" | "mentioned_only"
body#1body.platforms[][variant9].platformSpecificData.altTextarray<string>__125NoAlt text for each image, in the same order as mediaItems. Strongly encouraged for accessibility.
body#1body.platforms[][variant9].platformSpecificData.altText[]string__126
body#1body.platforms[][variant10]object__9_extends:__127
body#1body.platforms[][variant10].platformstring__128Yeskind: ; value: "googlebusiness"
body#1body.platforms[][variant10].accountIdstring__129YesIntegration._id — find yours via GET /connect/integrations
body#1body.platforms[][variant10].contentstring__130NoOptional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level content is used.
body#1body.platforms[][variant10].platformSpecificDataobject#/components/schemas/GoogleBusinessConfigurationsNoPass this object in platformSpecificData when posting to Google Business Profile. Posts appear on Google Search and Maps.
body#1body.platforms[][variant10].platformSpecificData.topicTypestring__131NoPost type. Defaults to STANDARD. Use EVENT for event posts, OFFER for promotional offer posts.kind: ; value: "STANDARD" | "EVENT" | "OFFER"
body#1body.platforms[][variant10].platformSpecificData.callToActionTypestring__132NoCall-to-action button shown on the post.kind: ; value: "BOOK" | "ORDER" | "SHOP" | "LEARN_MORE" | "SIGN_UP" | "CALL" | "GET_OFFER"
body#1body.platforms[][variant10].platformSpecificData.callToActionUrlstring__133NoURL for the call-to-action. Required for all CTA types except CALL.kind: ; value: uri
body#1body.platforms[][variant10].platformSpecificData.eventTitlestring__134NoEvent title. Required when topicType is EVENT.
body#1body.platforms[][variant10].platformSpecificData.eventStartDatestring__135NoEvent start date in YYYY-MM-DD format. Required when topicType is EVENT.
body#1body.platforms[][variant10].platformSpecificData.eventStartTimestring__136NoEvent start time in HH:MM (24-hour) format. Required when topicType is EVENT.
body#1body.platforms[][variant10].platformSpecificData.eventEndDatestring__137NoEvent end date in YYYY-MM-DD format. Required when topicType is EVENT.
body#1body.platforms[][variant10].platformSpecificData.eventEndTimestring__138NoEvent end time in HH:MM (24-hour) format. Required when topicType is EVENT.
body#1body.platforms[][variant10].platformSpecificData.offerCouponCodestring__139NoCoupon code for OFFER posts.
body#1body.platforms[][variant10].platformSpecificData.offerRedeemOnlineUrlstring__140NoOnline redemption URL for OFFER posts.kind: ; value: uri
body#1body.platforms[][variant10].platformSpecificData.offerTermsConditionsstring__141NoTerms and conditions text for OFFER posts.
body#1body.scheduledForstring__142NoNew ISO 8601 datetime. Omit to keep the current scheduled time.kind: ; value: date-time
body#1body.timezonestring__143NoIANA timezone for the scheduled time. Omit to keep the current one.
response#2responseobject__0
response#2response.successboolean__1Yes
response#2response.messagestring__2No
response#2response.postIdstring__3Yes
response#2response.scheduledForstring__4Nokind: schemaFormat; value: date-time
response#3responseobject__0
response#3response.successboolean__1Yes
response#3response.messagestring__2Yes