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

ghl-mcp-server-v2

by zackscriven

ghl_social_post_create

Create and schedule social media posts across connected platforms in one request, with per-platform details, media, drafts, or review workflows.

Instructions

KNOWN LIVE REGRESSION (as of 2026-07-04): this endpoint was observed broken/failing in production even though its documented schema (top-level accountIds/summary/media/status/type/userId, platform-specific *PostDetails objects) is correct and faithfully reproduced here. If a call fails, the schema/tool is not at fault — treat it as a possible server-side GHL issue and check the response body for details before assuming a client-side mistake. Create post Create posts for all supported platforms. It is possible to create customized posts per channel by using the same platform account IDs in a request and hitting the create post API multiple times with different summaries and account IDs per platform.

The content and media limitations, as well as platform rate limiters corresponding to the respective platforms, are provided in the following reference link:

Link: Platform Limitations Endpoint: POST /social-media-posting/{locationId}/posts (Version header: v3; source: v3/social-planner-v3.json) Requires a Sub-Account (location) token. OAuth scopes: socialplanner/post.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": {
      "locationId": "<locationId>",
      "body": "<body>"
    },
    "name": "ghl_social_post_create"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyYesRequest body (schema carried verbatim from the official OpenAPI spec).
locationIdYesLocation ID (also known as Sub-Account ID) for the business location.

Schema Changelog

Changes observed during successful MCP inspections.

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

TDQS

A3.8/5.0
Behavior4/5

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

Beyond the annotations (readOnly=false, idempotent=false), the description discloses the auth requirement (Sub-Account/location token), the OAuth scope socialplanner/post.write, the endpoint and version header, per-platform rate limiters, and cross-platform trimming side effects that silently alter content. The regression warning also sets expectations that failures may be server-side. It does not describe the response, which is a real gap with no output schema.

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

Conciseness3/5

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

The first and most prominent sentence is a dated regression caveat rather than the tool's purpose, and "Create post" redundantly restates the title. The remaining content is dense and useful but front-loading is suboptimal.

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

Completeness4/5

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

For a large nested mutation schema with no output schema, the description supplies the missing operational context: auth, endpoint, version, rate limits, and the multi-platform caption/media semantics. The main omission is any statement of what the call returns (post ID, per-platform child results), which would matter for verification and follow-up calls.

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 is exhaustively documented, so the schema carries the parameter burden. The description only names top-level fields (accountIds/summary/media/status/type/userId) and adds no validation or format detail beyond what the schema already states, so 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 posts for all supported platforms") and describes the shared-post-per-accountIds model, which separates it from ghl_social_edit_post and ghl_social_get_post. It does not name a sibling alternative explicitly, and the "Create post" line duplicates the title, so it stops short of 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 Guidelines4/5

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

It gives concrete when-to guidance: use the same platform account IDs and hit the create API multiple times for per-channel customization, and send one request per platform when a platform needs different media or a full-length caption. What's missing is explicit routing against siblings (e.g., edit vs create, queue-item creation).

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