Skip to main content
Glama
ghl-mcp-server-v2

ghl-mcp-server-v2

by zackscriven

ghl_social_create_queue_item

Creates a new post item in a social media queue, using an edit session ID or direct-to-queue insertion for immediate placement.

Instructions

Create a new item in the queue Adds a new post item to a queue. Use sessionId for edit session or directToQueue for immediate addition. Endpoint: POST /social-media-posting/category/queues/{queueId}/create/item (Version header: v3; source: v3/social-planner-v3.json) OAuth scopes: socialplanner/category.write

Tool call template

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

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "queueId": "<queueId>",
      "body": "<body>"
    },
    "name": "ghl_social_create_queue_item"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyYesRequest body (schema carried verbatim from the official OpenAPI spec).
queueIdYesCategory queue ID

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changedv2.1.0
    • changedInput schema / properties / body / properties / modifiedPostPayload / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "accountIds": {
      -        "description": "Account Ids (OAuth only)",
      -        "example": [
      -          "aF3KhyL8JIuBwzK3m7Ly_iVrVJ2uoXNF0wzcBzgl5_12554616564525983496"
      -        ],
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "applyWatermark": {
      -        "description": "Apply watermark to media in this post.\n\n**Note:** Watermarks are applied to images only. Videos are not watermarked.",
      -        "example": true,
      -        "type": "boolean"
      -      },
      -      "categoryId": {
      -        "description": "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.",
      -        "example": "65f151c99bc2bf3aaf970d72",
      -        "type": "string"
      -      },
      -      "createdBy": {
      -        "description": "Created By",
      -        "example": "Lx1EI6YIgQYMQi0ytFXv",
      -        "type": "string"
      -      },
      -      "facebookPostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Facebook Post Details"
      -      },
      -      "followUpComment": {
      -        "description": "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)",
      -        "example": "What do you think? Let us know in the comments!",
      -        "type": "string"
      -      },
      -      "gmbPostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "GMB Post Details",
      -        "example": {
      -          "actionType": "BOOK",
      -          "gmbEventType": "STANDARD",
      -          "url": "https://example.com"
      -        }
      -      },
      -      "instagramPostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Instagram Post Details"
      -      },
      -      "linkedinPostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Linkedin Post Details"
      -      },
      -      "locationId": {
      -        "description": "Location Id",
      -        "example": "ve9EPM428h8vShlRW1KT",
      -        "type": "string"
      -      },
      -      "media": {
      -        "description": "Post Media",
      -        "example": [
      -          {
      -            "altText": "A sunset over the ocean with silhouetted palm trees",
      -            "caption": "Sample caption",
      -            "type": "image/jpeg",
      -            "url": "https://example.com/image.jpg"
      -          }
      -        ],
      -        "items": {
      -          "properties": {
      -            "altText": {
      -              "description": "Alt text for accessibility. Supported on Instagram, Threads, Pinterest, Bluesky, and LinkedIn image posts (ignored for video and other platforms). Auto-truncated per platform: Pinterest 500, Instagram/Threads 1000, Bluesky 2000, LinkedIn 4086 chars.",
      -              "example": "A sunset over the ocean with silhouetted palm trees",
      -              "maxLength": 4086,
      -              "type": "string"
      -            },
      -            "caption": {
      -              "description": "Alt text or caption for the media. Used for accessibility and SEO.",
      -              "example": "Team meeting discussing Q4 marketing strategy",
      -              "type": "string"
      -            },
      -            "id": {
      -              "description": "Unique identifier for the media item. Used for tracking and referencing.",
      -              "example": "media_abc123xyz",
      -              "type": "string"
      -            },
      -            "isModified": {
      -              "description": "Flag indicating if the media was modified (watermarked, optimized, or processed).",
      -              "example": true,
      -              "type": "boolean"
      -            },
      -            "optimizedType": {
      -              "description": "MIME type of the optimized media. May differ from original if format conversion occurred.",
      -              "example": "image/jpeg",
      -              "type": "string"
      -            },
      -            "optimizedUrl": {
      -              "description": "URL of the optimized/compressed media. Set automatically when media optimization is enabled.\n\n**Enable Optimization:** Set `mediaOptimization: true` in the post request.",
      -              "example": "https://storage.googleapis.com/your-bucket/media/optimized-image.jpg",
      -              "type": "string"
      -            },
      -            "originalUrl": {
      -              "description": "Original media URL before any processing (watermarking/optimization). Set automatically by the system.",
      -              "example": "https://storage.googleapis.com/test/test/media/original.jpeg",
      -              "type": "string"
      -            },
      -            "thumbnail": {
      -              "description": "Cover image URL for a video media item.\n\n**Scope**\n- Applies to the **first video** in `media[]`. Values supplied on subsequent video items are ignored.\n- Has no effect on image-only media items.\n\n**Response behavior**\n- After the post is published, the resolved cover image is surfaced on the post-level `thumbnail` field of the response and is no longer echoed back inside `media[]`. This represents the post's primary cover image and the cover used for the first video.\n\n**Limitations**\n- Per-item thumbnails for multi-video posts are not supported. Each destination network exposes a single cover image per post for the leading video; this matches the behavior of the underlying social platform APIs.\n\n**Format**\n- Provide a publicly accessible JPEG or PNG URL. Animated formats and video URLs are not accepted.\n- Recommended: an image matching the orientation of your video and ≤ 2 MB.",
      -              "example": "https://storage.googleapis.com/test/test/media/test.jpeg",
      -              "type": "string"
      -            },
      -            "type": {
      -              "description": "MIME type of the media file. See Platform Limitations Guide for platform-specific format support.",
      -              "enum": [
      -                "image/jpeg",
      -                "image/jpg",
      -                "image/png",
      -                "image/gif",
      -                "video/mp4",
      -                "video/mov",
      -                "video/webm"
      -              ],
      -              "example": "image/jpeg",
      -              "type": "string"
      -            },
      -            "url": {
      -              "description": "Public URL of the media file. Must be a valid, accessible HTTPS URL.",
      -              "example": "https://storage.googleapis.com/your-bucket/media/image.jpg",
      -              "type": "string"
      -            },
      -            "watermarkedUrl": {
      -              "description": "URL of the media after watermarking. Set automatically when watermark is applied.",
      -              "example": "https://storage.googleapis.com/test/test/media/watermarked.jpeg",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "url",
      -            "type"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "ogTagsDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Og Tags Meta Data",
      -        "example": {
      -          "metaImage": "https://example.com/image.jpg",
      -          "metaLink": "https://www.yahoo.com/",
      -          "ogDescription": "Page Description",
      -          "ogTitle": "Page Title"
      -        }
      -      },
      -      "pinterestPostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Pinterest Post Details"
      -      },
      -      "postApprovalDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Post Approval Details",
      -        "example": {
      -          "approvalStatus": "pending",
      -          "approver": "iVrVJ2uoXNF0wzcBzgl5"
      -        }
      -      },
      -      "scheduleDate": {
      -        "description": "Schedule Date",
      -        "example": "2024-01-15T10:00:00Z",
      -        "type": "string"
      -      },
      -      "scheduleTimeUpdated": {
      -        "description": "Flag indicating if the schedule datetime was manually updated. Used for tracking rescheduled posts.",
      -        "example": true,
      -        "type": "boolean"
      -      },
      -      "selectedBestTime": {
      -        "description": "Selected Best Time slot for scheduling",
      -        "example": "2024-01-15T10:00:00Z",
      -        "type": "string"
      -      },
      -      "status": {
      -        "description": "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)",
      -        "example": "scheduled",
      -        "type": "object"
      -      },
      -      "summary": {
      -        "description": "Post Content",
      -        "example": "Hello World",
      -        "type": "string"
      -      },
      -      "tags": {
      -        "description": "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.",
      -        "example": [
      -          "65f151c99bc2bf3aaf970d72",
      -          "65f151c99bc2bf3aaf970d73"
      -        ],
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "tiktokPostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Tiktok Post Details",
      -        "example": {
      -          "enableComment": true,
      -          "enableDuet": false,
      -          "privacyLevel": "PUBLIC_TO_EVERYONE"
      -        }
      -      },
      -      "type": {
      -        "description": "Post Type must be one of the following values: - post, story, reel",
      -        "example": "post",
      -        "type": "object"
      -      },
      -      "userId": {
      -        "description": "User ID",
      -        "example": "sdfdsfdsfEWEsdfsdsW32dd",
      -        "type": "string"
      -      },
      -      "youtubePostDetails": {
      -        "allOf": [
      -          {
      -            "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"
      -          }
      -        ],
      -        "description": "Youtube Post Details"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "accountIds": {
      +        "description": "Account Ids (OAuth only)",
      +        "example": [
      +          "aF3KhyL8JIuBwzK3m7Ly_iVrVJ2uoXNF0wzcBzgl5_12554616564525983496"
      +        ],
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "applyWatermark": {
      +        "description": "Apply watermark to media in this post.\n\n**Note:** Watermarks are applied to images only. Videos are not watermarked.",
      +        "example": true,
      +        "type": "boolean"
      +      },
      +      "categoryId": {
      +        "description": "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.",
      +        "example": "65f151c99bc2bf3aaf970d72",
      +        "type": "string"
      +      },
      +      "communityPostDetails": {
      +        "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!"
      +        }
      +      },
      +      "createdBy": {
      +        "description": "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.",
      +        "example": "65f151c99bc2bf3aaf970d72",
      +        "type": "string"
      +      },
      +      "facebookPostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Facebook Post Details",
      +        "example": {
      +          "postType": "feed"
      +        }
      +      },
      +      "followUpComment": {
      +        "description": "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)",
      +        "example": "What do you think? Let us know in the comments!",
      +        "type": "string"
      +      },
      +      "gmbPostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "GMB Post Details",
      +        "example": {
      +          "topicType": "STANDARD"
      +        }
      +      },
      +      "instagramPostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Instagram Post Details",
      +        "example": {
      +          "collaborators": [],
      +          "type": "post"
      +        }
      +      },
      +      "linkedinPostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Linkedin Post Details",
      +        "example": {
      +          "pdfTitle": "Q4 Marketing Strategy Presentation",
      +          "postAsPdf": false
      +        }
      +      },
      +      "locationId": {
      +        "description": "Location Id",
      +        "example": "ve9EPM428h8vShlRW1KT",
      +        "type": "string"
      +      },
      +      "media": {
      +        "description": "Post Media",
      +        "example": [
      +          {
      +            "type": "image",
      +            "url": "https://example.com/image.jpg"
      +          }
      +        ],
      +        "items": {
      +          "properties": {
      +            "altText": {
      +              "description": "Alt text for accessibility. Supported on Instagram, Threads, Pinterest, Bluesky, and LinkedIn image posts (ignored for video and other platforms). Auto-truncated per platform: Pinterest 500, Instagram/Threads 1000, Bluesky 2000, LinkedIn 4086 chars.",
      +              "example": "A sunset over the ocean with silhouetted palm trees",
      +              "type": "string"
      +            },
      +            "caption": {
      +              "description": "Alt text or caption for the media. Used for accessibility and SEO.",
      +              "example": "Caption 1",
      +              "type": "string"
      +            },
      +            "defaultThumb": {
      +              "description": "Default thumbnail URL, auto-generated from video if not provided.",
      +              "example": "https://storage.googleapis.com/test/test/media/default-thumb.jpeg",
      +              "type": "string"
      +            },
      +            "id": {
      +              "description": "Unique identifier for the media item. Used for tracking and referencing.",
      +              "example": "media_abc123xyz",
      +              "type": "string"
      +            },
      +            "isModified": {
      +              "description": "Flag indicating if the media was modified (watermarked, optimized, or processed).",
      +              "example": true,
      +              "type": "boolean"
      +            },
      +            "optimizedType": {
      +              "description": "MIME type of the optimized media. May differ from original if format conversion occurred.",
      +              "example": "image/jpeg",
      +              "type": "string"
      +            },
      +            "optimizedUrl": {
      +              "description": "URL of the optimized/compressed media. Set automatically when media optimization is enabled.\n\n**Enable Optimization:** Set `mediaOptimization: true` in the post request.",
      +              "example": "https://storage.googleapis.com/your-bucket/media/optimized-image.jpg",
      +              "type": "string"
      +            },
      +            "originalUrl": {
      +              "description": "Original media URL before any processing (watermarking/optimization). Set automatically by the system.",
      +              "example": "https://storage.googleapis.com/test/test/media/original.jpeg",
      +              "type": "string"
      +            },
      +            "thumbnail": {
      +              "description": "Cover image URL for a video media item.\n\n**Scope**\n- Applies to the **first video** in `media[]`. Values supplied on subsequent video items are ignored.\n- Has no effect on image-only media items.\n\n**Response behavior**\n- After the post is published, the resolved cover image is surfaced on the post-level `thumbnail` field of the response and is no longer echoed back inside `media[]`. This represents the post's primary cover image and the cover used for the first video.\n\n**Limitations**\n- Per-item thumbnails for multi-video posts are not supported. Each destination network exposes a single cover image per post for the leading video; this matches the behavior of the underlying social platform APIs.\n\n**Format**\n- Provide a publicly accessible JPEG or PNG URL. Animated formats and video URLs are not accepted.\n- Recommended: an image matching the orientation of your video and ≤ 2 MB.",
      +              "example": "https://storage.googleapis.com/test/test/media/test.jpeg",
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "MIME type of the media file. See Platform Limitations Guide for platform-specific format support.",
      +              "enum": [
      +                "image/jpeg",
      +                "image/jpg",
      +                "image/png",
      +                "image/gif",
      +                "video/mp4",
      +                "video/mov",
      +                "video/webm"
      +              ],
      +              "example": "image/jpeg",
      +              "type": "string"
      +            },
      +            "url": {
      +              "description": "Public URL of the media file. Must be a valid, accessible HTTPS URL.",
      +              "example": "https://i0.wp.com/www.lifeofanarchitect.com/wp-content/uploads/2021/10/architectural-model-making-stairs.jpg",
      +              "type": "string"
      +            },
      +            "watermarkedUrl": {
      +              "description": "URL of the media after watermarking. Set automatically when watermark is applied.",
      +              "example": "https://storage.googleapis.com/test/test/media/watermarked.jpeg",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "url",
      +            "type"
      +          ],
      +          "title": "PostMediaSchema",
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "ogTagsDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Og Tags Meta Data",
      +        "example": {
      +          "metaImage": "https://example.com/image.jpg",
      +          "metaLink": "https://www.yahoo.com/",
      +          "ogDescription": "Page Description",
      +          "ogTitle": "Page Title"
      +        }
      +      },
      +      "pinterestPostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Pinterest Post Details",
      +        "example": {
      +          "boardIds": {
      +            "account_123": "board_123"
      +          },
      +          "link": "https://example.com",
      +          "title": "New collection"
      +        }
      +      },
      +      "postApprovalDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Post Approval Details",
      +        "example": {
      +          "approvalStatus": "pending",
      +          "approver": "iVrVJ2uoXNF0wzcBzgl5"
      +        }
      +      },
      +      "scheduleDate": {
      +        "description": "Schedule Date. Required when `status` is `scheduled` or `in_review`.",
      +        "example": "2024-01-15T10:00:00Z",
      +        "type": "string"
      +      },
      +      "scheduleTimeUpdated": {
      +        "description": "Flag indicating if the schedule datetime was manually updated. Used for tracking rescheduled posts.",
      +        "example": true,
      +        "type": "boolean"
      +      },
      +      "selectedBestTime": {
      +        "description": "Selected Best Time slot for scheduling",
      +        "example": "2024-01-15T10:00:00Z",
      +        "type": "string"
      +      },
      +      "status": {
      +        "description": "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)",
      +        "enum": [
      +          "draft",
      +          "scheduled",
      +          "in_review",
      +          "published",
      +          "in_progress",
      +          "pending",
      +          "failed",
      +          "notification_sent",
      +          "deleted"
      +        ],
      +        "example": "draft",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "description": "Post Content",
      +        "example": "Hello World",
      +        "type": "string"
      +      },
      +      "tags": {
      +        "description": "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.",
      +        "example": [
      +          "65f151c99bc2bf3aaf970d72",
      +          "65f151c99bc2bf3aaf970d73"
      +        ],
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "tiktokPostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Tiktok Post Details",
      +        "example": {
      +          "disableComment": false,
      +          "disableDuet": false,
      +          "disableStitch": false,
      +          "privacyLevel": "PUBLIC_TO_EVERYONE"
      +        }
      +      },
      +      "type": {
      +        "description": "Post Type must be one of the following values: post, story, reel, short",
      +        "enum": [
      +          "post",
      +          "story",
      +          "reel"
      +        ],
      +        "example": "post",
      +        "type": "string"
      +      },
      +      "userId": {
      +        "description": "User ID",
      +        "example": "sdfdsfdsfEWEsdfsdsW32dd",
      +        "type": "string"
      +      },
      +      "youtubePostDetails": {
      +        "allOf": [
      +          {
      +            "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"
      +          }
      +        ],
      +        "description": "Youtube Post Details",
      +        "example": {
      +          "description": "A short product walkthrough video.",
      +          "title": "Product walkthrough"
      +        }
      +      }
      +    },
      +    "title": "QueueModifiedPostDTO",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / properties / modifiedPostPayload / example
      Added value: +{
      +  "media": [],
      +  "summary": "New queued post content"
      +}
    • addedInput schema / properties / body / properties / variations / example
      Added value: +[
      +  {
      +    "content": "Try this variation",
      +    "mentions": [],
      +    "ogTags": {
      +      "metaLink": "https://example.com"
      +    }
      +  }
      +]
    • changedInput schema / properties / body / properties / variations / items / properties / ogTags / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "metaImage": {
      -        "description": "URL of the image to display in link preview.",
      -        "example": "https://example.com/images/preview.png",
      -        "type": "object"
      -      },
      -      "metaLink": {
      -        "description": "The canonical URL of the content for link preview.",
      -        "example": "https://example.com/blog/post-title",
      -        "type": "object"
      -      },
      -      "ogTitle": {
      -        "description": "Title to display in link preview.",
      -        "example": "Check out our latest blog post!",
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "metaImage": {
      +        "description": "URL of the image to display in link preview.",
      +        "example": "https://example.com/images/preview.png",
      +        "type": "string"
      +      },
      +      "metaLink": {
      +        "description": "The canonical URL of the content for link preview.",
      +        "example": "https://example.com/blog/post-title",
      +        "type": "string"
      +      },
      +      "ogTitle": {
      +        "description": "Title to display in link preview.",
      +        "example": "Check out our latest blog post!",
      +        "type": "string"
      +      }
      +    },
      +    "title": "OgTagsInputDTO",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / properties / variations / items / properties / ogTags / example
      Added value: +{
      +  "metaLink": "https://example.com",
      +  "ogTitle": "Article Title"
      +}
    • addedInput schema / properties / body / properties / variations / items / title
      Added value: +"VariationInputDTO"
    • addedInput schema / properties / body / title
      Added value: +"CreateQueueItemDTO"
    • addedInput schema / properties / queueId / description
      Added value: +"Category queue ID"
    • addedInput schema / properties / queueId / example
      Added value: +"507f1f77bcf86cd799439011"
  2. First observedv2.0.0

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false, idempotentHint=false, and destructiveHint=false, so the write/non-idempotent profile is covered. The description adds real value with the required OAuth scope (socialplanner/category.write) and the two operating modes, but says nothing about what the created item looks like or what errors occur when a session is invalid or the queue is paused.

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

Conciseness4/5

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

Front-loaded with the action and resource, followed by a single useful usage sentence and two compact metadata lines (endpoint, scope). No filler, though the first line largely restates the title and could be merged with the second.

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

Completeness3/5

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

For a mutation tool with a very deep nested body and no output schema, the description covers purpose, auth scope, and the two creation modes, which is the minimum viable. It omits preconditions (does the queue need to be active/paused? does sessionId have to be started first via ghl_social_start_edit_session?) and says nothing about the returned object.

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

Parameters3/5

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

Schema description coverage is 100% and the body schema already explains sessionId, directToQueue, and the order field in depth. The description's only added semantic is the sessionId-vs-directToQueue dichotomy, which is a marginal gain beyond the schema; baseline 3 applies.

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

Purpose4/5

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

The description states a specific verb and resource ('Create a new item in the queue / Adds a new post item to a queue') and names the concrete endpoint, so an agent can tell it apart from generic post creation. It does not explicitly differentiate from close siblings such as ghl_social_clone_queue_item or ghl_social_update_queue_item, which would have earned a 5.

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

Usage Guidelines3/5

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

The line 'Use sessionId for edit session or directToQueue for immediate addition' gives mode-selection guidance, which implies when each path applies. However, there is no explicit statement of when to use this tool versus alternatives like ghl_social_post_create, ghl_social_clone_queue_item, or when to use a queue at all.

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

Deploy Server

Other Tools