changedInput schema / properties / body / properties / accountIds / description
Previous value: -"Account IDs for the post. Each account ID identifies a connected social media account.\n\n**Get IDs from:** [Get Accounts API](./get-account) — use the `id` field from each account.\n\n**Validations:**\n- Required for non-draft posts\n- Must be a non-empty array\n- All account IDs must be valid connected accounts for the location"New value: +"Account IDs for the post. Each account ID identifies a connected social media account.\n\n**Get IDs from:** [Get Accounts API](/social-media-posting/oauth/{locationId}/accounts) — use the `id` field from each account.\n\n**One request = one post, shared across every account in this list.**\n- All accounts share the same `summary` and the same `media` array.\n- `summary` is trimmed to the **strictest** character limit among the selected platforms. Adding a Bluesky account (300 chars) therefore trims the caption to 300 for Facebook, Instagram and LinkedIn in that same request.\n- `media` is capped to each platform's own maximum at publish time (e.g. Bluesky publishes the first 4 items, Instagram the first 10).\n- **To keep full-length, platform-specific captions, send one request per platform** - one post per platform, each with only that platform's account IDs.\n\n**Validations:**\n- Required for non-draft posts\n- Must be a non-empty array\n- All account IDs must be valid connected accounts for the location"
changedInput schema / properties / body / properties / categoryId / description
Previous value: -"Category ID to organize the post. Categories help group related posts.\n\n**Get Category IDs from:** [Get Categories API](./social-planner/get-categories-location-id) — use the `_id` field.\n\n**Validation:** Must be a valid MongoDB ObjectId."New value: +"Category ID to organize the post. Categories help group related posts.\n\n**Get Category IDs from:** [Get Categories API](/social-media-posting/{locationId}/categories) — use the `_id` field.\n\n**Validation:** Must be a valid 24-character hex ID."
addedInput schema / properties / body / properties / communityPostDetails
Added value: +{
+ "allOf": [
+ {
+ "properties": {
+ "notifyAllGroupMembers": {
+ "description": "Notify every member of the group when the post is published, equivalent to an `@everyone` broadcast prepended to the post content.\n\n**Use Case:** Enable for announcements that all members should see.\n\n**Default:** `false`",
+ "example": true,
+ "type": "boolean"
+ },
+ "postAsUser": {
+ "description": "The Community member each post is published as, keyed by Community account ID.\n\n**Structure:** `{ accountId: { id, name, avatar } }`\n\n- **Key** — the Community account ID. This is the same value you pass in `accountIds`: take it from the `id` field of a Community account in the Get Accounts API, not the `oauthId` field.\n- `id` (required) — `contactId` of the member to publish as, from the Get Community Members API.\n- `name` (optional) — display name shown as the post author.\n- `avatar` (optional) — profile image URL shown against the post.\n\n**Required:** Yes. Every Community account listed in `accountIds` must have an entry here, otherwise the request is rejected.\n\n**Member eligibility:** the member must be an active member of the group and hold a role in it. This is checked again at publish time, so a member who leaves the group or loses access between scheduling and publishing causes that post to fail. Use the Validate Community Member API to confirm a stored member is still eligible before scheduling.\n\n**Private channels:** list members per account rather than reusing one list across accounts — for a private channel only that channel's members may be posted as.",
+ "example": {
+ "aF3KhyL8JIuBwzK3m7Ly_iVrVJ2uoXNF0wzcBzgl5_12554616564525983496": {
+ "avatar": "https://storage.googleapis.com/revex-communities/avatars/jane.png",
+ "id": "YBjxnYiXJKmoyV7WDjjG",
+ "name": "Jane Cooper"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "Title of the community post. Displayed as the post headline.\n\n**Max length:** 1,000 characters\n\n**Required:** Yes, for all Community posts.",
+ "example": "Welcome to Our New Community Feature!",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title",
+ "postAsUser"
+ ],
+ "title": "CommunityPostSchema",
+ "type": "object"
+ }
+ ],
+ "description": "Community-specific post configuration for Communities.\n\n**Required Fields:**\n- `title`: Post title (max 1,000 characters)\n- `postAsUser`: the member to publish as, keyed by Community account ID\n\n**Optional Fields:**\n- `notifyAllGroupMembers`: notify all group members (`@everyone` broadcast)\n\n**Limits:**\n- Max 4 media items\n- Caption max 100,000 characters\n\n**Required when** `accountIds` contains a Community account and the post is not a draft.",
+ "example": {
+ "notifyAllGroupMembers": false,
+ "postAsUser": {
+ "aF3KhyL8JIuBwzK3m7Ly_iVrVJ2uoXNF0wzcBzgl5_12554616564525983496": {
+ "id": "YBjxnYiXJKmoyV7WDjjG",
+ "name": "Jane Cooper"
+ }
+ },
+ "title": "Welcome to our community!"
+ }
+}
changedInput schema / properties / body / properties / createdBy / description
Previous value: -"User ID of the creator who is creating/managing the post. Must be a valid MongoDB ObjectId.\n\n**Get User IDs from:** [Get User API](../users/get-user) — use the `id` field from the user object.\n\n**Validation:** Must be a valid MongoDB ObjectId."New value: +"User ID of the creator who is creating/managing the post. Must be a valid 24-character hex ID.\n\n**Get User IDs from:** [Get User API](/users/{userId}) — use the `id` field from the user object.\n\n**Validation:** Must be a valid 24-character hex ID."
changedInput schema / properties / body / properties / facebookPostDetails / allOf
Previous value: -[
- {
- "properties": {
- "textFormatPresetId": {
- "description": "Facebook background preset ID for text-only feed posts. **Facebook `post` only** — not `story` or `reel`. Ignored when media is attached; `metaLink` is omitted on publish.\n\n**Validations** — request returns `400` if violated:\n- Must be a valid preset ID from the [Facebook text background preset reference](https://help.leadconnectorhq.com/support/solutions/articles/155000008005-facebook-text-background-posts-preset-reference). Empty strings, whitespace-only values, and `null` are rejected.\n- When set, `summary` must be 130 characters or fewer.",
- "example": "303063890126415",
- "type": "string"
- },
- "type": {
- "description": "Facebook post format type.\n\n**Available Types:**\n- `post` - Standard feed post (images, videos, text)\n- `story` - 24-hour temporary story\n- `reel` - Short-form vertical video\n\n**Restrictions:**\n- Reels: Require exactly 1 video, not supported on Groups\n- Stories: Captions not supported",
- "enum": [
- "post",
- "story",
- "reel"
- ],
- "example": "post",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "textFormatPresetId": {
+ "description": "Facebook background preset ID for text-only feed posts. **Facebook `post` only** — not `story` or `reel`. Ignored when media is attached; `metaLink` is omitted on publish.\n\n**Validations** — request returns `400` if violated:\n- Must be a valid preset ID from the [Facebook text background preset reference](https://help.leadconnectorhq.com/support/solutions/articles/155000008005-facebook-text-background-posts-preset-reference). Empty strings, whitespace-only values, and `null` are rejected.\n- When set, `summary` must be 130 characters or fewer.",
+ "example": "303063890126415",
+ "type": "string"
+ },
+ "type": {
+ "description": "Facebook post format type.\n\n**Available Types:**\n- `post` - Standard feed post (images, videos, text)\n- `story` - 24-hour temporary story\n- `reel` - Short-form vertical video\n\n**Restrictions:**\n- Reels: Require exactly 1 video, not supported on Groups\n- Stories: Captions not supported",
+ "enum": [
+ "post",
+ "story",
+ "reel"
+ ],
+ "example": "post",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FacebookPostSchema",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / facebookPostDetails / example
Added value: +{
+ "type": "feed"
+}
changedInput schema / properties / body / properties / followUpComment / description
Previous value: -"Follow-up comment to be posted immediately after the main post is published.\n\n**Supported Platforms:** Facebook, Instagram, LinkedIn, YouTube\n\n**NOT Supported:** TikTok, Google My Business (GMB), Pinterest\n\n**Use Case:** Great for adding hashtags, additional context, or engagement prompts without cluttering the main post.\n\n- Follow-up comment is automatically trimmed to platform limits\n\n**Reference:** [Platform Limitations Guide](https://help.leadconnectorhq.com/support/solutions/articles/48001240003-social-planner-image-video-content-and-api-limitations)"New value: +"Follow-up comment to be posted immediately after the main post is published.\n\n**Supported Platforms:** Facebook, Instagram, LinkedIn, Community, Threads, Bluesky, YouTube, TikTok\n\n**NOT Supported:** GBP (Google Business Profile), Pinterest\n\n- TikTok: posted once the video becomes publicly viewable (~1-3 min), not instantly\n\n- TikTok: only public videos support a follow-up comment. Set `privacyLevel` to `PUBLIC_TO_EVERYONE` — friends-only and private videos are not supported\n\n**Use Case:** Great for adding hashtags, additional context, or engagement prompts without cluttering the main post.\n\n- Like `summary`, the follow-up comment is trimmed to the **strictest** limit among the post's platforms, not to each platform's own limit — a post that includes Bluesky (300) trims the comment to 300 everywhere. Send one request per platform to keep the full comment on each.\n\n**Reference:** [Platform Limitations Guide](https://help.leadconnectorhq.com/support/solutions/articles/48001240003-social-planner-image-video-content-and-api-limitations)"
changedInput schema / properties / body / properties / gmbPostDetails / allOf
Previous value: -[
- {
- "properties": {
- "actionType": {
- "description": "Call-to-action button type for the post.\n\n**Available Actions:**\n- `none` - No action button\n- `order` - Order online\n- `book` - Book appointment\n- `shop` - Shop now\n- `learn_more` - Learn more\n- `call` - Call now (no URL required)\n- `sign_up` - Sign up\n\n**Note:** All actions except `none` and `call` require a `url`.",
- "enum": [
- "none",
- "order",
- "book",
- "shop",
- "learn_more",
- "call",
- "sign_up"
- ],
- "example": "book",
- "type": "string"
- },
- "couponCode": {
- "description": "Promotional coupon code. Required for OFFER posts.",
- "example": "SAVE50",
- "type": "string"
- },
- "endDate": {
- "allOf": [
- {
- "properties": {
- "endDate": {
- "allOf": [
- {
- "properties": {
- "day": {
- "description": "Day component of the date (1-31)",
- "example": 1,
- "type": "number"
- },
- "month": {
- "description": "Month component of the date (1-12)",
- "example": 1,
- "type": "number"
- },
- "year": {
- "description": "Year component of the date",
- "example": 2022,
- "type": "number"
- }
- },
- "required": [
- "year",
- "month",
- "day"
- ],
- "type": "object"
- }
- ],
- "description": "End Date",
- "example": {
- "day": 20,
- "month": 1,
- "year": 2024
- }
- },
- "endTime": {
- "allOf": [
- {
- "properties": {
- "hours": {
- "description": "Hour component of the time (0-23)",
- "example": 23,
- "type": "number"
- },
- "minutes": {
- "description": "Minute component of the time (0-59)",
- "example": 56,
- "type": "number"
- },
- "seconds": {
- "description": "Second component of the time (0-59)",
- "example": 34,
- "type": "number"
- }
- },
- "required": [
- "hours",
- "minutes",
- "seconds"
- ],
- "type": "object"
- }
- ],
- "description": "End Time",
- "example": {
- "hours": 18,
- "minutes": 0,
- "seconds": 0
- }
- }
- },
- "type": "object"
- }
- ],
- "description": "End date and time for EVENT or OFFER posts.\n\n**Required:** When `gmbEventType` is `EVENT` or `OFFER`.\n**Validation:** Must be after `startDate`.\n\n**Structure:**\n- `endDate`: { year, month, day }\n- `endTime`: { hours, minutes, seconds }",
- "example": {
- "endDate": {
- "day": 20,
- "month": 1,
- "year": 2024
- },
- "endTime": {
- "hours": 18,
- "minutes": 0,
- "seconds": 0
- }
- }
- },
- "gmbEventType": {
- "description": "Google My Business post type.\n\n**Available Types:**\n- `STANDARD` - Regular update post (What's New)\n- `EVENT` - Event announcement with dates and title\n- `OFFER` - Promotional offer with coupon and redemption details\n\n**Required fields by type:**\n- STANDARD: None additional\n- EVENT: `title`, `startDate`, `endDate`\n- OFFER: `offerTitle`, `startDate`, `endDate`, `termsConditions`, `couponCode`, `redeemOnlineUrl`",
- "enum": [
- "STANDARD",
- "EVENT",
- "OFFER"
- ],
- "example": "STANDARD",
- "type": "string"
- },
- "offerTitle": {
- "description": "Offer title. Required when `gmbEventType` is `OFFER`.",
- "example": "50% Off All Products",
- "type": "string"
- },
- "redeemOnlineUrl": {
- "description": "URL where customers can redeem the offer online. Required for OFFER posts.",
- "example": "https://yoursite.com/redeem-offer",
- "type": "string"
- },
- "startDate": {
- "allOf": [
- {
- "properties": {
- "startDate": {
- "allOf": [
- {
- "properties": {
- "day": {
- "description": "Day component of the date (1-31)",
- "example": 1,
- "type": "number"
- },
- "month": {
- "description": "Month component of the date (1-12)",
- "example": 1,
- "type": "number"
- },
- "year": {
- "description": "Year component of the date",
- "example": 2022,
- "type": "number"
- }
- },
- "required": [
- "year",
- "month",
- "day"
- ],
- "type": "object"
- }
- ],
- "description": "Start Date",
- "example": {
- "day": 15,
- "month": 1,
- "year": 2024
- }
- },
- "startTime": {
- "allOf": [
- {
- "properties": {
- "hours": {
- "description": "Hour component of the time (0-23)",
- "example": 23,
- "type": "number"
- },
- "minutes": {
- "description": "Minute component of the time (0-59)",
- "example": 56,
- "type": "number"
- },
- "seconds": {
- "description": "Second component of the time (0-59)",
- "example": 34,
- "type": "number"
- }
- },
- "required": [
- "hours",
- "minutes",
- "seconds"
- ],
- "type": "object"
- }
- ],
- "description": "Start Time",
- "example": {
- "hours": 10,
- "minutes": 30,
- "seconds": 0
- }
- }
- },
- "type": "object"
- }
- ],
- "description": "Start date and time for EVENT or OFFER posts.\n\n**Required:** When `gmbEventType` is `EVENT` or `OFFER`.\n\n**Structure:**\n- `startDate`: { year, month, day }\n- `startTime`: { hours, minutes, seconds }",
- "example": {
- "startDate": {
- "day": 15,
- "month": 1,
- "year": 2024
- },
- "startTime": {
- "hours": 10,
- "minutes": 0,
- "seconds": 0
- }
- }
- },
- "termsConditions": {
- "description": "URL to terms and conditions page. Required for OFFER posts.",
- "example": "https://yoursite.com/terms-and-conditions",
- "type": "string"
- },
- "title": {
- "description": "Event title. Required when `gmbEventType` is `EVENT`.\n\n**Max length:** 58 characters",
- "example": "Summer Sale Event 2024",
- "type": "string"
- },
- "url": {
- "description": "Call-to-action URL. Required when `actionType` is set (except `none` and `call`).\n\n**Required for:** STANDARD and EVENT posts with actionType other than `none` or `call`.",
- "example": "https://yoursite.com/book-now",
- "type": "string"
- }
- },
- "required": [
- "gmbEventType"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "actionType": {
+ "description": "Call-to-action button type for the post.\n\n**Available Actions:**\n- `none` - No action button\n- `order` - Order online\n- `book` - Book appointment\n- `shop` - Shop now\n- `learn_more` - Learn more\n- `call` - Call now (no URL required)\n- `sign_up` - Sign up\n\n**Note:** All actions except `none` and `call` require a `url`.",
+ "enum": [
+ "none",
+ "order",
+ "book",
+ "shop",
+ "learn_more",
+ "call",
+ "sign_up"
+ ],
+ "example": "book",
+ "type": "string"
+ },
+ "couponCode": {
+ "description": "Promotional coupon code. Required for OFFER posts.",
+ "example": "SAVE50",
+ "type": "string"
+ },
+ "endDate": {
+ "allOf": [
+ {
+ "properties": {
+ "endDate": {
+ "allOf": [
+ {
+ "properties": {
+ "day": {
+ "description": "Day component of the date (1-31)",
+ "example": 1,
+ "type": "number"
+ },
+ "month": {
+ "description": "Month component of the date (1-12)",
+ "example": 1,
+ "type": "number"
+ },
+ "year": {
+ "description": "Year component of the date",
+ "example": 2022,
+ "type": "number"
+ }
+ },
+ "required": [
+ "year",
+ "month",
+ "day"
+ ],
+ "title": "DateSchema",
+ "type": "object"
+ }
+ ],
+ "description": "End Date",
+ "example": {
+ "day": 20,
+ "month": 1,
+ "year": 2024
+ }
+ },
+ "endTime": {
+ "allOf": [
+ {
+ "properties": {
+ "hours": {
+ "description": "Hour component of the time (0-23)",
+ "example": 23,
+ "type": "number"
+ },
+ "minutes": {
+ "description": "Minute component of the time (0-59)",
+ "example": 56,
+ "type": "number"
+ },
+ "seconds": {
+ "description": "Second component of the time (0-59)",
+ "example": 34,
+ "type": "number"
+ }
+ },
+ "required": [
+ "hours",
+ "minutes",
+ "seconds"
+ ],
+ "title": "TimeSchema",
+ "type": "object"
+ }
+ ],
+ "description": "End Time",
+ "example": {
+ "hours": 18,
+ "minutes": 0,
+ "seconds": 0
+ }
+ }
+ },
+ "title": "EndDateSchema",
+ "type": "object"
+ }
+ ],
+ "description": "End date and time for EVENT or OFFER posts.\n\n**Required:** When `gmbEventType` is `EVENT` or `OFFER`.\n**Validation:** Must be after `startDate`.\n\n**Structure:**\n- `endDate`: { year, month, day }\n- `endTime`: { hours, minutes, seconds }",
+ "example": {
+ "endDate": {
+ "day": 20,
+ "month": 1,
+ "year": 2024
+ },
+ "endTime": {
+ "hours": 18,
+ "minutes": 0,
+ "seconds": 0
+ }
+ }
+ },
+ "gmbEventType": {
+ "description": "Google My Business post type.\n\n**Available Types:**\n- `STANDARD` - Regular update post (What's New)\n- `EVENT` - Event announcement with dates and title\n- `OFFER` - Promotional offer with coupon and redemption details\n\n**Required fields by type:**\n- STANDARD: None additional\n- EVENT: `title`, `startDate`, `endDate`\n- OFFER: `offerTitle`, `startDate`, `endDate`, `termsConditions`, `couponCode`, `redeemOnlineUrl`",
+ "enum": [
+ "STANDARD",
+ "EVENT",
+ "OFFER"
+ ],
+ "example": "STANDARD",
+ "type": "string"
+ },
+ "offerTitle": {
+ "description": "Offer title. Required when `gmbEventType` is `OFFER`.",
+ "example": "50% Off All Products",
+ "type": "string"
+ },
+ "redeemOnlineUrl": {
+ "description": "URL where customers can redeem the offer online. Required for OFFER posts.",
+ "example": "https://yoursite.com/redeem-offer",
+ "type": "string"
+ },
+ "startDate": {
+ "allOf": [
+ {
+ "properties": {
+ "startDate": {
+ "allOf": [
+ {
+ "properties": {
+ "day": {
+ "description": "Day component of the date (1-31)",
+ "example": 1,
+ "type": "number"
+ },
+ "month": {
+ "description": "Month component of the date (1-12)",
+ "example": 1,
+ "type": "number"
+ },
+ "year": {
+ "description": "Year component of the date",
+ "example": 2022,
+ "type": "number"
+ }
+ },
+ "required": [
+ "year",
+ "month",
+ "day"
+ ],
+ "title": "DateSchema",
+ "type": "object"
+ }
+ ],
+ "description": "Start Date",
+ "example": {
+ "day": 15,
+ "month": 1,
+ "year": 2024
+ }
+ },
+ "startTime": {
+ "allOf": [
+ {
+ "properties": {
+ "hours": {
+ "description": "Hour component of the time (0-23)",
+ "example": 23,
+ "type": "number"
+ },
+ "minutes": {
+ "description": "Minute component of the time (0-59)",
+ "example": 56,
+ "type": "number"
+ },
+ "seconds": {
+ "description": "Second component of the time (0-59)",
+ "example": 34,
+ "type": "number"
+ }
+ },
+ "required": [
+ "hours",
+ "minutes",
+ "seconds"
+ ],
+ "title": "TimeSchema",
+ "type": "object"
+ }
+ ],
+ "description": "Start Time",
+ "example": {
+ "hours": 10,
+ "minutes": 30,
+ "seconds": 0
+ }
+ }
+ },
+ "title": "StartDateSchema",
+ "type": "object"
+ }
+ ],
+ "description": "Start date and time for EVENT or OFFER posts.\n\n**Required:** When `gmbEventType` is `EVENT` or `OFFER`.\n\n**Structure:**\n- `startDate`: { year, month, day }\n- `startTime`: { hours, minutes, seconds }",
+ "example": {
+ "startDate": {
+ "day": 15,
+ "month": 1,
+ "year": 2024
+ },
+ "startTime": {
+ "hours": 10,
+ "minutes": 0,
+ "seconds": 0
+ }
+ }
+ },
+ "termsConditions": {
+ "description": "URL to terms and conditions page. Required for OFFER posts.",
+ "example": "https://yoursite.com/terms-and-conditions",
+ "type": "string"
+ },
+ "title": {
+ "description": "Event title. Required when `gmbEventType` is `EVENT`.\n\n**Max length:** 58 characters",
+ "example": "Summer Sale Event 2024",
+ "type": "string"
+ },
+ "url": {
+ "description": "Call-to-action URL. Required when `actionType` is set (except `none` and `call`).\n\n**Required for:** STANDARD and EVENT posts with actionType other than `none` or `call`.",
+ "example": "https://yoursite.com/book-now",
+ "type": "string"
+ }
+ },
+ "required": [
+ "gmbEventType"
+ ],
+ "title": "GMBPostSchema",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / instagramPostDetails / allOf
Previous value: -[
- {
- "properties": {
- "collaborators": {
- "description": "Object mapping account IDs to arrays of associated usernames for collaboration. Only allowed for type \"post\" and \"reels\"",
- "example": {
- "accountId1": [
- "username1",
- "username2"
- ],
- "accountId2": [
- "username3",
- "username4"
- ]
- },
- "type": "object"
- },
- "publishViaPushNotification": {
- "description": "Send Instagram Story via Push Notification instead of direct posting. Only applicable for Story type.",
- "example": true,
- "type": "boolean"
- },
- "publisherNote": {
- "description": "Note to the publisher for manual posting guidance. Only used when publishViaPushNotification is true.",
- "example": "When publishing, add swipe up link to the landing page so that we can direct them to the sales page",
- "type": "string"
- },
- "showOnFeed": {
- "description": "Show Reel on profile grid/feed.\n\n**✅ Applies to:** Reels only\n\n- `true` - Reel appears on your profile grid\n- `false` - Reel only appears in Reels tab",
- "example": true,
- "type": "boolean"
- },
- "type": {
- "description": "Instagram post format type.\n\n**Available Types:**\n- `post` - Standard feed post (images, videos, carousels)\n- `story` - 24-hour temporary story\n- `reel` - Short-form vertical video (up to 90 seconds)\n\n**Restrictions:**\n- Media is REQUIRED for all Instagram posts\n- Reels: Require exactly 1 video\n- Stories: Captions not supported, JPEG only for images",
- "enum": [
- "post",
- "story",
- "reel"
- ],
- "example": "post",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "collaborators": {
+ "description": "Collaboration invites mapping account IDs to Instagram usernames.\n\n**Structure:** `{ accountId: [username1, username2, username3] }`\n\n- **Key:** Account ID from `accountIds` array (the Instagram account posting)\n- **Value:** Array of Instagram usernames to invite as collaborators\n\n**Get Account IDs from:** [Get Accounts API](/social-media-posting/oauth/{locationId}/accounts) — use the `id` field from Instagram accounts.\n\n**✅ Supported for:** Posts and Reels only (NOT Stories)\n\n**Validations:**\n- Maximum 5 collaborators per account\n- No duplicate usernames allowed\n- Usernames are Instagram handles without @\n\n**Use Case:** Invite other Instagram users to collaborate. Once accepted, the post appears on both profiles.",
+ "example": {
+ "640ab864e8e47e7f8a186425_hE998piDgAGZDY1xzmFD_17841453046826624": [
+ "influencer_username",
+ "partner_brand"
+ ]
+ },
+ "type": "object"
+ },
+ "notificationSentCount": {
+ "description": "Number of push notifications sent for this Instagram Story. Tracks how many notifications have been sent out.",
+ "example": 1,
+ "type": "number"
+ },
+ "postedVia": {
+ "description": "Source of where the post was marked as published. Values: \"web\" (web interface), \"mobile\" (mobile app), or null.",
+ "enum": [
+ "web",
+ "mobile"
+ ],
+ "example": "web",
+ "type": "string"
+ },
+ "publishViaPushNotification": {
+ "description": "Send Instagram Story via Push Notification instead of direct posting. Only applicable for Story type.",
+ "example": true,
+ "type": "boolean"
+ },
+ "publisherNote": {
+ "description": "Note to the publisher for manual posting guidance. Only used when publishViaPushNotification is true.",
+ "example": "When publishing, add swipe up link to the landing page so that we can direct them to the sales page",
+ "type": "string"
+ },
+ "showOnFeed": {
+ "description": "Show Reel on profile grid/feed.\n\n**✅ Applies to:** Reels only\n\n- `true` - Reel appears on your profile grid\n- `false` - Reel only appears in Reels tab",
+ "example": true,
+ "type": "boolean"
+ },
+ "type": {
+ "description": "Instagram post format type.\n\n**Available Types:**\n- `post` - Standard feed post (images, videos, carousels)\n- `story` - 24-hour temporary story\n- `reel` - Short-form vertical video (up to 90 seconds)\n\n**Restrictions:**\n- Media is REQUIRED for all Instagram posts\n- Reels: Require exactly 1 video\n- Stories: Captions not supported, JPEG only for images",
+ "enum": [
+ "post",
+ "story",
+ "reel"
+ ],
+ "example": "post",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "InstagramPostSchema",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / instagramPostDetails / description
Previous value: -"Instagram-specific post configuration.\n\n**Key Fields:**\n- `type`: Post type (`post`, `story`, `reel`)\n- `collaborators`: Map of account IDs to Instagram usernames for collaboration invites (max 3 per account)\n- `showOnFeed`: Show reel on profile feed (for reels)\n\n**Collaborators Structure:**\n```json\n{ \"accountId\": [\"username1\", \"username2\"] }\n```\nWhere `accountId` is from [Get Accounts API](./get-account) and usernames are Instagram handles without @.\n\n**Restrictions:**\n- Media is REQUIRED for all Instagram posts\n- Max 30 hashtags allowed in caption\n- Stories do not support captions\n- Collaborators: Posts/Reels only (NOT Stories)\n- Reels require exactly 1 video\n\n**Reference:** [Platform Limitations Guide](https://help.leadconnectorhq.com/support/solutions/articles/48001240003-social-planner-image-video-content-and-api-limitations)"New value: +"Instagram-specific post configuration.\n\n**Key Fields:**\n- `type`: Post type (`post`, `story`, `reel`)\n- `collaborators`: Map of account IDs to Instagram usernames for collaboration invites (max 5 per account)\n- `showOnFeed`: Show reel on profile feed (for reels)\n\n**Collaborators Structure:**\n```json\n{ \"accountId\": [\"username1\", \"username2\"] }\n```\nWhere `accountId` is from [Get Accounts API](/social-media-posting/oauth/{locationId}/accounts) and usernames are Instagram handles without @.\n\n**Restrictions:**\n- Media is REQUIRED for all Instagram posts\n- Max 30 hashtags allowed in caption\n- Stories do not support captions\n- Collaborators: Posts/Reels only (NOT Stories)\n- Reels require exactly 1 video\n\n**Reference:** [Platform Limitations Guide](https://help.leadconnectorhq.com/support/solutions/articles/48001240003-social-planner-image-video-content-and-api-limitations)"
addedInput schema / properties / body / properties / instagramPostDetails / example
Added value: +{
+ "share_to_feed": true,
+ "type": "feed"
+}
changedInput schema / properties / body / properties / linkedinPostDetails / allOf
Previous value: -[
- {
- "properties": {
- "pdfTitle": {
- "description": "Title for the PDF document carousel. Displayed as the document name on LinkedIn.\n\n**Max length:** 100 characters\n\n**Tip:** Use a descriptive title that explains the document content.",
- "example": "Q4 Marketing Strategy Presentation",
- "type": "string"
- },
- "poll": {
- "allOf": [
- {
- "properties": {
- "options": {
- "description": "Poll options. Minimum 2, maximum 4. Each option text max 30 characters. Option texts must be unique.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "text": {
- "description": "Text describing the option. Max length: 30 characters.",
- "example": "Red",
- "maxLength": 30,
- "type": "string"
- }
- },
- "required": [
- "text"
- ],
- "type": "object"
- },
- "maxItems": 4,
- "minItems": 2,
- "type": "array",
- "uniqueItems": true
- },
- "question": {
- "description": "Question for the poll. Max length: 140 characters.",
- "example": "What is your favorite color?",
- "maxLength": 140,
- "type": "string"
- },
- "settings": {
- "allOf": [
- {
- "properties": {
- "duration": {
- "description": "Duration the poll stays open for votes.",
- "enum": [
- "ONE_DAY",
- "THREE_DAYS",
- "SEVEN_DAYS",
- "FOURTEEN_DAYS"
- ],
- "example": "SEVEN_DAYS",
- "type": "string"
- }
- },
- "required": [
- "duration"
- ],
- "type": "object"
- }
- ],
- "description": "Poll settings (duration)."
- }
- },
- "required": [
- "question",
- "options",
- "settings"
- ],
- "type": "object"
- }
- ],
- "description": "Publish a LinkedIn poll post.\n\n**Required fields when `poll` is supplied:**\n- `question` (max 140 characters)\n- `options`: 2 to 4 entries, each `text` ≤ 30 characters; option texts must be unique\n- `settings.duration`: one of `ONE_DAY`, `THREE_DAYS`, `SEVEN_DAYS`, `FOURTEEN_DAYS`\n\n**LinkedIn restrictions:**\n- Polls cannot be edited after publishing.\n- A poll post cannot include `media` or a meta-link preview."
- },
- "postAsPdf": {
- "description": "Post images as a PDF document carousel.\n\n**Limits:**\n- Max 300 pages/images\n- Max PDF size: 100 MB",
- "example": true,
- "type": "boolean"
- }
- },
- "required": [
- "pdfTitle",
- "postAsPdf"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "pdfTitle": {
+ "description": "Title for the PDF document carousel. Displayed as the document name on LinkedIn.\n\n**Max length:** 100 characters\n\n**Tip:** Use a descriptive title that explains the document content.",
+ "example": "Q4 Marketing Strategy Presentation",
+ "type": "string"
+ },
+ "poll": {
+ "allOf": [
+ {
+ "properties": {
+ "options": {
+ "description": "Poll options. Minimum 2, maximum 4. Each option text max 30 characters. Option texts must be unique.",
+ "example": [
+ {
+ "text": "Blue"
+ },
+ {
+ "text": "Green"
+ }
+ ],
+ "items": {
+ "properties": {
+ "text": {
+ "description": "Text describing the option. Max length: 30 characters.",
+ "example": "Red",
+ "maxLength": 30,
+ "type": "string"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "title": "LinkedinPollOptionDto",
+ "type": "object"
+ },
+ "maxItems": 4,
+ "minItems": 2,
+ "type": "array"
+ },
+ "question": {
+ "description": "Question for the poll. Max length: 140 characters.",
+ "example": "What is your favorite color?",
+ "maxLength": 140,
+ "type": "string"
+ },
+ "settings": {
+ "allOf": [
+ {
+ "properties": {
+ "duration": {
+ "description": "Duration the poll stays open for votes.",
+ "enum": [
+ "ONE_DAY",
+ "THREE_DAYS",
+ "SEVEN_DAYS",
+ "FOURTEEN_DAYS"
+ ],
+ "example": "SEVEN_DAYS",
+ "type": "string"
+ }
+ },
+ "required": [
+ "duration"
+ ],
+ "title": "LinkedinPollSettingsDto",
+ "type": "object"
+ }
+ ],
+ "description": "Poll settings (duration).",
+ "example": {
+ "duration": "SEVEN_DAYS"
+ }
+ }
+ },
+ "required": [
+ "question",
+ "options",
+ "settings"
+ ],
+ "title": "LinkedinPollDto",
+ "type": "object"
+ }
+ ],
+ "description": "Publish a LinkedIn poll post.\n\n**Required fields when `poll` is supplied:**\n- `question` (max 140 characters)\n- `options`: 2 to 4 entries, each `text` ≤ 30 characters; option texts must be unique\n- `settings.duration`: one of `ONE_DAY`, `THREE_DAYS`, `SEVEN_DAYS`, `FOURTEEN_DAYS`\n\n**LinkedIn restrictions:**\n- Polls cannot be edited after publishing.\n- A poll post cannot include `media` or a meta-link preview.",
+ "example": {
+ "options": [
+ {
+ "text": "Blue"
+ },
+ {
+ "text": "Green"
+ }
+ ],
+ "question": "What is your favorite color?",
+ "settings": {
+ "duration": "SEVEN_DAYS"
+ }
+ }
+ },
+ "postAsPdf": {
+ "description": "Post images as a PDF document carousel.\n\n**Limits:**\n- Max 300 pages/images\n- Max PDF size: 100 MB",
+ "example": true,
+ "type": "boolean"
+ }
+ },
+ "title": "LinkedinPostSchema",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / linkedinPostDetails / example
Added value: +{
+ "visibility": "PUBLIC"
+}
changedInput schema / properties / body / properties / media / description
Previous value: -"Post Media Data \n The limitations of media as per the platforms is provided through the reference link in API description"New value: +"Post Media Data. Per-platform media limits are listed in the reference link in the API description.\n\n**Across multiple platforms:** the same media array is sent to every account in `accountIds` and capped to each platform's own maximum at publish time — the array is NOT reduced to the strictest limit the way `summary` is. An 8-item array publishes 8 items to Facebook and the first 4 to Bluesky.\nSend one request per platform if a platform needs a different set of media."
changedInput schema / properties / body / properties / media / example
Previous value: -[
- {
- "altText": "A sunset over the ocean with silhouetted palm trees",
- "caption": "Sample caption",
- "type": "image/jpeg",
- "url": "https://example.com/image.jpg"
- }
-]New value: +[
+ {
+ "caption": "Sample caption",
+ "type": "image/jpeg",
+ "url": "https://example.com/image.jpg"
+ }
+]
removedInput schema / properties / body / properties / media / items / properties / altText / maxLength
Removed value: -4086
changedInput schema / properties / body / properties / media / items / properties / caption / example
Previous value: -"Team meeting discussing Q4 marketing strategy"New value: +"Caption 1"
addedInput schema / properties / body / properties / media / items / properties / defaultThumb
Added value: +{
+ "description": "Default thumbnail URL, auto-generated from video if not provided.",
+ "example": "https://storage.googleapis.com/test/test/media/default-thumb.jpeg",
+ "type": "string"
+}
changedInput schema / properties / body / properties / media / items / properties / url / example
Previous value: -"https://storage.googleapis.com/your-bucket/media/image.jpg"New value: +"https://i0.wp.com/www.lifeofanarchitect.com/wp-content/uploads/2021/10/architectural-model-making-stairs.jpg"
addedInput schema / properties / body / properties / media / items / title
Added value: +"PostMediaSchema"
changedInput schema / properties / body / properties / ogTagsDetails / allOf
Previous value: -[
- {
- "properties": {
- "metaImage": {
- "description": "Preview image URL for the shared link.\n\n**Best Practices:**\n- Use high-quality images (1200x630px recommended)\n- Ensure the image is publicly accessible\n\n**Auto-fetch:** Use the Get Metatags API to fetch OG data from a URL.",
- "example": "https://yoursite.com/images/og-image.jpg",
- "type": "string"
- },
- "metaLink": {
- "description": "URL of the webpage being shared. This is the destination when users click the link preview.",
- "example": "https://yoursite.com/blog/amazing-article",
- "type": "string"
- },
- "ogDescription": {
- "description": "Custom description for the link preview. Overrides the page's og:description meta tag.\n\n**Tip:** Keep descriptions under 155 characters for optimal display.",
- "example": "Learn proven strategies to boost your social media engagement and grow your audience.",
- "type": "string"
- },
- "ogTitle": {
- "description": "Custom title for the link preview. Overrides the page's og:title meta tag.\n\n**Tip:** Keep titles concise (50-60 characters) for best display across platforms.",
- "example": "How to Double Your Social Media Engagement",
- "type": "string"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "metaImage": {
+ "description": "Preview image URL for the shared link.\n\n**Best Practices:**\n- Use high-quality images (1200x630px recommended)\n- Ensure the image is publicly accessible\n\n**Auto-fetch:** Use the Get Metatags API to fetch OG data from a URL.",
+ "example": "https://yoursite.com/images/og-image.jpg",
+ "type": "string"
+ },
+ "metaLink": {
+ "description": "URL of the webpage being shared. This is the destination when users click the link preview.",
+ "example": "https://yoursite.com/blog/amazing-article",
+ "type": "string"
+ },
+ "ogDescription": {
+ "description": "Custom description for the link preview. Overrides the page's og:description meta tag.\n\n**Tip:** Keep descriptions under 155 characters for optimal display.",
+ "example": "Learn proven strategies to boost your social media engagement and grow your audience.",
+ "type": "string"
+ },
+ "ogTitle": {
+ "description": "Custom title for the link preview. Overrides the page's og:title meta tag.\n\n**Tip:** Keep titles concise (50-60 characters) for best display across platforms.",
+ "example": "How to Double Your Social Media Engagement",
+ "type": "string"
+ }
+ },
+ "title": "OgTagsSchema",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / pinterestPostDetails / allOf
Previous value: -[
- {
- "properties": {
- "boardIds": {
- "additionalProperties": {
- "type": "string"
- },
- "deprecated": true,
- "description": "**DEPRECATED — use `pinterestBoards` instead.** Will be removed on July 31, 2026.\n\nLegacy mapping of Pinterest account OAuth IDs to a single board ID:\n`{ accountOAuthId: \"boardId\" }`\n\nFor multi-board posting, use `pinterestBoards`.",
- "example": {
- "6887d6de1d8175813d50dab8": "987654321098765432"
- },
- "type": "object"
- },
- "link": {
- "description": "Destination URL for the pin. Users clicking the pin will be directed to this URL.\n\n**Max length:** 2048 characters\n\n**Best Practices:**\n- Use direct links to relevant content\n- Track with UTM parameters for analytics",
- "example": "https://yoursite.com/blog/home-decor-ideas",
- "type": "string"
- },
- "pinterestBoards": {
- "description": "Per-account Pinterest board selection. Each entry binds one connected Pinterest account to a list of boards on that account. Each board produces an independent child post tracked separately for success/failure. Capped at 25 boards per account.\n\nWhen supplied, this field takes precedence over the deprecated `boardIds` field.",
- "example": [
- {
- "accountId": "6887d6de1d8175813d50dab8",
- "boards": [
- "987654321098765432",
- "234567890123456789"
- ]
- },
- {
- "accountId": "682c7d1710a2fe3d805a3513",
- "boards": [
- "111222333444555666"
- ]
- }
- ],
- "items": {
- "description": "Per-account Pinterest board selection. Each entry binds one connected Pinterest account to a list of board IDs the pin should publish to. Each selected board produces an independent child post tracked separately for success/failure.",
- "properties": {
- "accountId": {
- "description": "Connected Pinterest account ID. Must match one of the accounts referenced in the post's `userIds`.",
- "example": "6887d6de1d8175813d50dab8",
- "type": "string"
- },
- "boards": {
- "description": "Pinterest board IDs to publish to on this account. Each board produces an independent child post. Capped at 25 boards per account.",
- "example": [
- "987654321098765432",
- "234567890123456789"
- ],
- "items": {
- "type": "string"
- },
- "maxItems": 25,
- "minItems": 1,
- "type": "array"
- }
- },
- "required": [
- "accountId",
- "boards"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "shortenedLinks": {
- "description": "Shortened links for the post (auto-generated).",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "title": {
- "description": "Pin title displayed on Pinterest.\n\n**Max length:** 100 characters\n\n**Best Practices:**\n- Include relevant keywords\n- Be descriptive and engaging",
- "example": "10 Easy Home Decor Ideas for 2024",
- "type": "string"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "boardIds": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "deprecated": true,
+ "description": "**DEPRECATED — use `pinterestBoards` instead.** Will be removed on July 31, 2026.\n\nLegacy mapping of Pinterest account OAuth IDs to a single board ID:\n`{ accountOAuthId: \"boardId\" }`\n\nFor multi-board posting, use `pinterestBoards`.",
+ "example": {
+ "6887d6de1d8175813d50dab8": "987654321098765432"
+ },
+ "type": "object"
+ },
+ "link": {
+ "description": "Destination URL for the pin. Users clicking the pin will be directed to this URL.\n\n**Max length:** 2048 characters\n\n**Best Practices:**\n- Use direct links to relevant content\n- Track with UTM parameters for analytics",
+ "example": "https://yoursite.com/blog/home-decor-ideas",
+ "type": "string"
+ },
+ "pinterestBoards": {
+ "description": "Per-account Pinterest board selection. Each entry binds one connected Pinterest account to a list of boards on that account. Each board produces an independent child post tracked separately for success/failure. Capped at 25 boards per account.\n\nWhen supplied, this field takes precedence over the deprecated `boardIds` field.",
+ "example": [
+ {
+ "accountId": "6887d6de1d8175813d50dab8",
+ "boards": [
+ "987654321098765432",
+ "234567890123456789"
+ ]
+ },
+ {
+ "accountId": "682c7d1710a2fe3d805a3513",
+ "boards": [
+ "111222333444555666"
+ ]
+ }
+ ],
+ "items": {
+ "properties": {
+ "accountId": {
+ "description": "Connected Pinterest account ID. Must match one of the accounts referenced in the post's `userIds`.",
+ "example": "6887d6de1d8175813d50dab8",
+ "type": "string"
+ },
+ "boards": {
+ "description": "Pinterest board IDs to publish to on this account. Each board produces an independent child post tracked separately for success/failure. Capped at 25 boards per account.",
+ "example": [
+ "987654321098765432",
+ "234567890123456789"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "accountId",
+ "boards"
+ ],
+ "title": "PinterestBoardSelection",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "shortenedLinks": {
+ "description": "Shortened links for the post (auto-generated).",
+ "example": [
+ {
+ "originalUrl": "https://example.com",
+ "shortenedUrl": "https://short.link/abc"
+ }
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "title": {
+ "description": "Pin title displayed on Pinterest.\n\n**Max length:** 100 characters\n\n**Best Practices:**\n- Include relevant keywords\n- Be descriptive and engaging",
+ "example": "10 Easy Home Decor Ideas for 2024",
+ "type": "string"
+ }
+ },
+ "title": "PinterestPostSchema",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / pinterestPostDetails / example
Added value: +{
+ "boardId": "123456789",
+ "title": "Pin Title"
+}
changedInput schema / properties / body / properties / postApprovalDetails / allOf
Previous value: -[
- {
- "properties": {
- "approvalStatus": {
- "description": "Current approval status of the post.\n\n**Available Values:**\n- `pending` - Awaiting approver review\n- `approved` - Approved and ready for publishing\n- `rejected` - Rejected by approver (needs revision)\n- `not_required` - No approval workflow needed",
- "enum": [
- "pending",
- "approved",
- "rejected",
- "not_required"
- ],
- "example": "pending",
- "type": "string"
- },
- "approver": {
- "description": "User ID of the designated approver.\n\n**Note:** The approver will receive a notification when a post is submitted for review.",
- "example": "iVrVJ2uoXNF0wzcBzgl5",
- "type": "string"
- },
- "approverNote": {
- "description": "Note from the approver to the post creator with feedback or approval comments.",
- "example": "Approved! Great content. Consider adding more hashtags for visibility.",
- "type": "string"
- },
- "requesterNote": {
- "description": "Note from the post creator to the approver explaining the post or requesting specific feedback.",
- "example": "Please review the messaging for our Q4 campaign launch. Let me know if the CTA needs adjustment.",
- "type": "string"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "approvalStatus": {
+ "description": "Current approval status of the post.\n\n**Available Values:**\n- `pending` - Awaiting approver review\n- `approved` - Approved and ready for publishing\n- `rejected` - Rejected by approver (needs revision)\n- `not_required` - No approval workflow needed",
+ "enum": [
+ "pending",
+ "approved",
+ "rejected",
+ "not_required"
+ ],
+ "example": "pending",
+ "type": "string"
+ },
+ "approver": {
+ "description": "User ID of the designated approver.\n\n**Note:** The approver will receive a notification when a post is submitted for review.",
+ "example": "iVrVJ2uoXNF0wzcBzgl5",
+ "type": "string"
+ },
+ "approverNote": {
+ "description": "Note from the approver to the post creator with feedback or approval comments.",
+ "example": "Approved! Great content. Consider adding more hashtags for visibility.",
+ "type": "string"
+ },
+ "requesterNote": {
+ "description": "Note from the post creator to the approver explaining the post or requesting specific feedback.",
+ "example": "Please review the messaging for our Q4 campaign launch. Let me know if the CTA needs adjustment.",
+ "type": "string"
+ }
+ },
+ "title": "PostApprovalSchema",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / scheduleDate / description
Previous value: -"Schedule Date"New value: +"Schedule Date. Required when `status` is `scheduled` or `in_review`."
changedInput schema / properties / body / properties / status / description
Previous value: -"Post status indicating the current state of the post.\n\n**Available Status Values:**\n- `draft` - Post saved as draft, not yet ready for publishing\n- `scheduled` - Post scheduled for future publishing (requires `scheduleDate`)\n- `in_review` - Post pending approval (requires `scheduleDate` and `postApprovalDetails`)\n- `published` - Post has been published\n- `in_progress` - Post is currently being processed\n- `pending` - Post is awaiting platform processing for Instagram media container creation\n- `failed` - Post publishing failed\n- `notification_sent` - Story notification sent (for manual story posting)\n- `deleted` - Post has been deleted\n\n**Validations:**\n- `scheduled` or `in_review` status requires `scheduleDate` to be set\n- Draft posts skip most validations (accountIds, media requirements)"New value: +"Post status indicating the current state of the post.\n\n**Available Status Values:**\n- `draft` - Post saved as draft, not yet ready for publishing\n- `scheduled` - Post scheduled for future publishing (requires `scheduleDate`)\n- `in_review` - Post pending approval (requires `scheduleDate` and `postApprovalDetails`)\n- `published` - Post has been published\n- `in_progress` - Post is currently being processed\n- `pending` - Post is awaiting platform processing for Instagram media container creation\n- `failed` - Post publishing failed\n- `notification_sent` - Story notification sent (for manual story posting)\n- `deleted` - Post has been deleted\n\n**Validations:**\n- `scheduled` or `in_review` status requires `scheduleDate` to be set\n- Submitting for review (`in_review`) requires `postApprovalDetails.approver`; approve/reject actions reuse the stored approver\n- Draft posts skip most validations (accountIds, media requirements)"
changedInput schema / properties / body / properties / status / example
Previous value: -"scheduled"New value: +"draft"
changedInput schema / properties / body / properties / summary / description
Previous value: -"Post content/caption text. Character limits vary by platform.\n\n**Custom Values & Hashtags:**\n- You can include custom values/variables in the content (e.g., `{{contact.name}}`)\n- Hashtags: Use `#hashtag` format. Instagram allows max 30 hashtags.\n- Mentions: Use platform-specific mention format (see `mentions` field for structured mentions)\n\n**Validations:**\n- Instagram/Facebook Story: Caption NOT supported for direct publishing\n- Facebook, LinkedIn, GMB: Content OR media is required (at least one)\n- Content is automatically trimmed to platform limits\n\n**Reference:** [Platform Limitations Guide](https://help.leadconnectorhq.com/support/solutions/articles/48001240003-social-planner-image-video-content-and-api-limitations)"New value: +"Post content/caption text. Character limits vary by platform.\n\n**Custom Values & Hashtags:**\n- You can include custom values/variables in the content (e.g., `{{contact.name}}`)\n- Hashtags: Use `#hashtag` format. Instagram allows max 30 hashtags.\n- Mentions: Use platform-specific mention format (see `mentions` field for structured mentions)\n\n**Validations:**\n- Instagram/Facebook Story: Caption NOT supported for direct publishing\n- Facebook, LinkedIn, GMB: Content OR media is required (at least one)\n\n**Trimming across multiple platforms:**\nOne post carries ONE caption for every account in `accountIds`, so the caption is silently trimmed to the **strictest** limit among the selected platforms — not to each platform's own limit.\n- Facebook 63,206 · LinkedIn 3,000 · Instagram / TikTok 2,200 · Google 1,500 · Pinterest 800 · Threads 500 · **Bluesky 300**\n- Example: `accountIds` covering Facebook + Instagram + Bluesky trims the caption to **300 characters on all three**.\n- Instagram/Facebook Stories without push-notification publishing force the limit to 0, dropping the caption entirely.\n- **To keep the full caption on each platform, send one request per platform** instead of one request mixing platforms.\n\n**Reference:** [Platform Limitations Guide](https://help.leadconnectorhq.com/support/solutions/articles/48001240003-social-planner-image-video-content-and-api-limitations)"
changedInput schema / properties / body / properties / tags / description
Previous value: -"Array of Tag IDs to associate with the post for organization and filtering.\n\n**Get Tag IDs from:** [Get Tags API](./social-planner/get-tags-location-id) — use the `_id` field from each tag.\n\n**Validation:** All IDs must be valid MongoDB ObjectIds."New value: +"Array of Tag IDs to associate with the post for organization and filtering.\n\n**Get Tag IDs from:** [Get Tags API](/social-media-posting/{locationId}/tags) — use the `_id` field from each tag.\n\n**Validation:** All IDs must be valid 24-character hex IDs."
changedInput schema / properties / body / properties / tiktokPostDetails / allOf
Previous value: -[
- {
- "properties": {
- "enableComment": {
- "description": "Allow users to comment on the video. Default is determined by account settings.",
- "example": true,
- "type": "boolean"
- },
- "enableDuet": {
- "description": "Allow users to create Duet videos with your content.\n\n**Duet:** Side-by-side video featuring your content and the creator's reaction/addition.",
- "example": true,
- "type": "boolean"
- },
- "enableStitch": {
- "description": "Allow users to create Stitch videos with your content.\n\n**Stitch:** Clips up to 5 seconds of your video that creators can use in their own videos.",
- "example": true,
- "type": "boolean"
- },
- "privacyLevel": {
- "description": "Privacy level controlling who can view the video.\n\n**Available Values:**\n- `PUBLIC_TO_EVERYONE` - Anyone can view (default)\n- `MUTUAL_FOLLOW_FRIENDS` - Only mutual followers can view\n- `SELF_ONLY` - Only you can view (private)\n\n**Note:** If set to `SELF_ONLY`, `videoDisclosure` must be `false`.",
- "enum": [
- "PUBLIC_TO_EVERYONE",
- "MUTUAL_FOLLOW_FRIENDS",
- "SELF_ONLY"
- ],
- "example": "PUBLIC_TO_EVERYONE",
- "type": "string"
- },
- "promoteOtherBrand": {
- "description": "Indicates if the video promotes a third-party brand or product.\n\n**Required:** Must be `true` if `videoDisclosure` is enabled and you're promoting another brand.",
- "example": false,
- "type": "boolean"
- },
- "promoteYourBrand": {
- "description": "Indicates if the video promotes your own brand or product.\n\n**Required:** Must be `true` if `videoDisclosure` is enabled and you're promoting your own brand.",
- "example": false,
- "type": "boolean"
- },
- "videoDisclosure": {
- "description": "Enable branded content disclosure. Required when video is promotional content.\n\n**Validations:**\n- Cannot be `true` if `privacyLevel` is `SELF_ONLY`\n- If enabled, at least one of `promoteYourBrand` or `promoteOtherBrand` must be `true`",
- "example": false,
- "type": "boolean"
- }
- },
- "required": [
- "privacyLevel"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "enableComment": {
+ "description": "Allow users to comment on the video. Default is determined by account settings.",
+ "example": true,
+ "type": "boolean"
+ },
+ "enableDuet": {
+ "description": "Allow users to create Duet videos with your content.\n\n**Duet:** Side-by-side video featuring your content and the creator's reaction/addition.",
+ "example": true,
+ "type": "boolean"
+ },
+ "enableStitch": {
+ "description": "Allow users to create Stitch videos with your content.\n\n**Stitch:** Clips up to 5 seconds of your video that creators can use in their own videos.",
+ "example": true,
+ "type": "boolean"
+ },
+ "privacyLevel": {
+ "description": "Privacy level controlling who can view the video.\n\n**Available Values:**\n- `PUBLIC_TO_EVERYONE` - Anyone can view (default)\n- `MUTUAL_FOLLOW_FRIENDS` - Only mutual followers can view\n- `SELF_ONLY` - Only you can view (private)\n\n**Note:** If set to `SELF_ONLY`, `videoDisclosure` must be `false`.",
+ "enum": [
+ "PUBLIC_TO_EVERYONE",
+ "MUTUAL_FOLLOW_FRIENDS",
+ "SELF_ONLY"
+ ],
+ "example": "PUBLIC_TO_EVERYONE",
+ "type": "string"
+ },
+ "promoteOtherBrand": {
+ "description": "Indicates if the video promotes a third-party brand or product.\n\n**Required:** Must be `true` if `videoDisclosure` is enabled and you're promoting another brand.",
+ "example": false,
+ "type": "boolean"
+ },
+ "promoteYourBrand": {
+ "description": "Indicates if the video promotes your own brand or product.\n\n**Required:** Must be `true` if `videoDisclosure` is enabled and you're promoting your own brand.",
+ "example": false,
+ "type": "boolean"
+ },
+ "videoDisclosure": {
+ "description": "Enable branded content disclosure. Required when video is promotional content.\n\n**Validations:**\n- Cannot be `true` if `privacyLevel` is `SELF_ONLY`\n- If enabled, at least one of `promoteYourBrand` or `promoteOtherBrand` must be `true`",
+ "example": false,
+ "type": "boolean"
+ }
+ },
+ "title": "TiktokPostSchema",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / youtubePostDetails / allOf
Previous value: -[
- {
- "properties": {
- "privacyLevel": {
- "description": "Video visibility/privacy setting.\n\n**Available Values:**\n- `public` - Anyone can search and view\n- `unlisted` - Only people with the link can view\n- `private` - Only you can view",
- "enum": [
- "private",
- "public",
- "unlisted"
- ],
- "example": "public",
- "type": "string"
- },
- "title": {
- "description": "Video title displayed on YouTube.\n\n**Max length:** 100 characters\n\n**Best Practices:**\n- Include relevant keywords\n- Be descriptive but concise\n- Avoid clickbait",
- "example": "How to Build a Successful Marketing Strategy in 2024",
- "type": "string"
- },
- "type": {
- "description": "YouTube video format type.\n\n**Available Types:**\n- `video` - Standard YouTube video (landscape, any duration)\n- `short` - YouTube Shorts (vertical, up to 60 seconds)\n\n**Required field.**",
- "enum": [
- "video",
- "short"
- ],
- "example": "video",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "privacyLevel": {
+ "description": "Video visibility/privacy setting.\n\n**Available Values:**\n- `public` - Anyone can search and view\n- `unlisted` - Only people with the link can view\n- `private` - Only you can view",
+ "enum": [
+ "private",
+ "public",
+ "unlisted"
+ ],
+ "example": "public",
+ "type": "string"
+ },
+ "title": {
+ "description": "Video title displayed on YouTube.\n\n**Max length:** 100 characters\n\n**Best Practices:**\n- Include relevant keywords\n- Be descriptive but concise\n- Avoid clickbait",
+ "example": "How to Build a Successful Marketing Strategy in 2024",
+ "type": "string"
+ },
+ "type": {
+ "description": "YouTube video format type.\n\n**Available Types:**\n- `video` - Standard YouTube video (landscape, any duration)\n- `short` - YouTube Shorts (vertical, up to 60 seconds)\n\n**Required field.**",
+ "enum": [
+ "video",
+ "short"
+ ],
+ "example": "video",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "YoutubePostSchema",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / youtubePostDetails / example
Added value: +{
+ "privacyStatus": "public",
+ "title": "Video Title"
+}
changedInput schema / properties / body / required
Previous value: -[
- "type",
- "accountIds",
- "userId"
-]New value: +[
+ "type"
+]
addedInput schema / properties / body / title
Added value: +"CreatePostDTO"
changedInput schema / properties / locationId / description
Previous value: -"Location Id"New value: +"Location ID (also known as Sub-Account ID) for the business location."
addedInput schema / properties / locationId / example
Added value: +"ve9EPM428h8vShlRW1KT"