Create a comment or reply

POST 
/social-media-posting/comments/:platform

Create a top-level comment on a post (isParentThread: true, parentId = postId) or a reply to an existing comment (isParentThread: false, parentId = commentId). Per-platform content max length: Facebook 8000, Instagram 2200, Linkedin 3000, Community 8000, Tiktok 150, Bluesky 300, Youtube 10000, Threads 500.

Optional-field platform support:

• attachments — supported on Facebook only. Ignored on Instagram, LinkedIn, TikTok, Bluesky, Community (Community processes the field but external URLs are not rendered due to its bucket restriction).
• mentions — supported on Facebook, LinkedIn, and Community only. Ignored on Instagram, TikTok, Bluesky.
• notifyAllGroupMembers — supported on Community only. When true, all group members get a push/in-app notification (equivalent to an @everyone broadcast). Independent of the mentions array and of @everyone text in content. Default false.

Request

Version stringrequired

API Version

Available optionsv3

platform stringrequired

Supported Comments Platforms

Available optionsfacebookinstagramlinkedincommunitytiktokblueskyyoutubethreads

locationId stringrequired

Location ID

application/json

application/json

Body

Bodyrequired

parentIdstringrequired

For top-level comments (isParentThread: true): pass the post ID returned by the posts API. For replies (isParentThread: false): pass the parent comment ID returned by the list-comments API. In both cases this must be a valid 24-character Highlevel ID — not the native platform ID.

isParentThreadbooleanrequired

Set true to create a top-level comment on a post (parentId = post ID). Set false to create a reply to an existing comment (parentId = comment ID).

contentstringrequired

Content of the comment. Per-platform max length: Facebook 8000, Instagram 2200, Linkedin 3000, Community 8000, Tiktok 150, Bluesky 300, Youtube 10000, Threads 500.

attachmentsobject[]

Attachments for the comment (max 1 image). Supported on: Facebook only. Not supported on: Instagram, LinkedIn, TikTok, Bluesky, Community — the field is accepted by the API but the attachment will not appear on the comment. (Community processes the field server-side, but external URLs are not rendered due to its bucket restriction.)

mentionsobject[]

Mentions for the comment. Supported on: Facebook, LinkedIn, Community. Ignored on: Instagram, TikTok, Bluesky — the field is accepted but mentions are not rendered on these platforms.

notifyAllGroupMembersboolean

When true, all members of the Community group receive a push/in-app notification about this comment — equivalent to an @everyone broadcast.

Supported on: Community only. Ignored on all other platforms (the field is accepted but no notification is sent).

Independent of the mentions array — you do not need to add an @everyone entry to mentions for this to take effect. Conversely, putting the literal text @everyone in content does not by itself trigger notifications; only this flag does.

Defaults to false (no broadcast notification). Use true only when the comment is genuinely intended for every member of the group — overuse may cause members to mute the group.

Example (auto)

{
  "parentId": "6975b186f3442844ec07665b",
  "isParentThread": true,
  "content": "This is a comment",
  "attachments": [
    {
      "url": "https://example.com/image.jpg",
      "type": "image"
    }
  ],
  "mentions": [
    {
      "name": "Test",
      "id": "102694781978972",
      "offset": "106",
      "length": "106",
      "slug": "mohammed-marvan-8bRf3H"
    }
  ],
  "notifyAllGroupMembers": false
}

application/json

Successful response

application/json

Schema

Schema

successbooleanrequired

Success or Failure

statusCodenumberrequired

Status Code

messagestringrequired

Message

resultsobjectrequired

The created comment

Example (auto)

{
  "success": true,
  "statusCode": 201,
  "message": "Created Comment",
  "results": {
    "_id": "507f1f77bcf86cd799439011",
    "platform": "facebook",
    "platformCommentId": "122129390871181019_974705035458625",
    "platformParentId": "956033194258752_122129390871181019",
    "platformPostId": "122129390871181019",
    "postId": "6a169db95c78177a5c24ef7c",
    "originId": "956033194258752",
    "isParentThread": true,
    "isPost": false,
    "content": "Nice post!",
    "attachments": [
      {
        "type": "image/jpeg",
        "url": "https://example.com/image.jpg",
        "thumbnail": "https://example.com/thumb.jpg",
        "videoUrl": "https://example.com/video.mp4"
      }
    ],
    "author": {
      "id": "123456789",
      "name": "John Doe",
      "profilePic": "https://example.com/avatar.jpg"
    },
    "level": 1,
    "likeCount": 0,
    "reactionCount": 0,
    "replyCount": 0,
    "shareCount": 0,
    "repostCount": 0,
    "quoteCount": 0,
    "previewLink": "https://www.facebook.com/.../posts/...",
    "isRead": false,
    "isDeleted": false,
    "isEdited": false,
    "publishedAt": "2026-04-01T10:00:00.000Z",
    "createdAt": "2026-04-01T10:00:00.000Z",
    "updatedAt": "2026-04-01T10:00:00.000Z"
  }
}