Comments

Comments are the public replies under your posts. Pozy lists them for every connected account that supports them, lets you answer from any of your accounts, and fires comment.received the moment a new one arrives. The same endpoints work whether the post was published through Pozy or directly on the platform.

#Find posts with comments

GET /v1/inbox/comments returns posts that have comments, newest first, with their commentCount, likeCount and permalink. Filter with profileId, accountId, platform, since and minComments, and sort by date or comments.

Boosted and ad posts from connected Meta ad accounts show up too, flagged isAd: true with adId and a placement of facebook or instagram. Filter them with platform=metaads.

#Read a post's comments

curl "https://api.pozy.ai/v1/inbox/comments/17912345678901234?accountId=6650c1e2a3b4c5d6e7f80a22&limit=25" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/inbox/comments/17912345678901234?accountId=6650c1e2a3b4c5d6e7f80a22&limit=25", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

for (const c of data.comments) {
  console.log(c.from.username, c.message, { canHide: c.canHide, canLike: c.canLike });
}

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/inbox/comments/17912345678901234",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"accountId": "6650c1e2a3b4c5d6e7f80a22", "limit": 25},
    timeout=30,
)
for c in resp.json()["comments"]:
    print(c["from"]["username"], c["message"])

postId is the platform's post id (a YouTube video id on YouTube). Each comment comes with capability flags (canReply, canDelete, canHide, canLike) and state (isHidden, isLiked), so your UI can show only the actions that will work. from.isOwner marks comments written by the connected account itself.

To page through the replies under one comment, pass commentId (Facebook, Instagram, Reddit and TikTok). Bluesky comments carry a cid you need for likes and replies.

#Reply

POST /v1/inbox/comments/{postId} posts a comment. Add commentId to reply under a specific comment, leave it out to comment on the post itself.

curl -X POST https://api.pozy.ai/v1/inbox/comments/17912345678901234 \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1d2c7a-5a8e-4c43-8f0e-2b6d1a9e7c10" \
  -d '{
    "accountId": "6650c1e2a3b4c5d6e7f80a22",
    "commentId": "18034567890123456",
    "message": "Thanks! The link is in our bio."
  }'

import { randomUUID } from "node:crypto";

const res = await fetch("https://api.pozy.ai/v1/inbox/comments/17912345678901234", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Idempotency-Key": randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    accountId: "6650c1e2a3b4c5d6e7f80a22",
    commentId: "18034567890123456",
    message: "Thanks! The link is in our bio.",
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.data.commentId);

import uuid

resp = requests.post(
    "https://api.pozy.ai/v1/inbox/comments/17912345678901234",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={"accountId": "6650c1e2a3b4c5d6e7f80a22", "commentId": "18034567890123456", "message": "Thanks! The link is in our bio."},
    timeout=30,
)
print(resp.json())

With an Idempotency-Key, a retry of the same body within 24 hours replays the first response instead of posting twice. The same key with a different body answers 422, and a key whose first request is still running answers 409. Reddit replies need the subreddit; Bluesky replies need parentCid, rootUri and rootCid from the thread.

#Moderate and engage

Hidden comments stay visible to the commenter and to page admins, which makes hiding a gentler tool than deleting. On X, you can only hide replies in conversations your account started.

LinkedIn reactions take an optional reactionType (LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT). Because any connected account can like any post, a brand can have its executives' accounts react to the company post.

#DM a commenter

On Instagram and Facebook you can answer a comment privately: POST /v1/inbox/comments/{postId}/{commentId}/private-reply sends a DM to the comment's author.

• One private reply per comment, within 7 days of the comment.
• Add up to 13 quickReplies or 1 to 3 buttons (not both).
• Instagram can refuse buttons, cards and attachments to people who do not follow the account. That refusal spends the comment's one private reply, so open with plain text when you are not sure. See Comment to DM.

To do this automatically on keywords, use a comment-to-DM automation instead of calling this yourself.

#The comment.received event

comment.received fires for new comments on Instagram, Facebook, Threads, YouTube, LinkedIn, Bluesky, Reddit and TikTok. It carries the comment (id, text, author, isReply, parentCommentId, createdAt) and the post it belongs to. A few fields are worth branching on:

• comment.postId is the Pozy post id, or null when the post was published outside Pozy. platformPostId is always set.
• comment.author.isOwnAccount is true for comments the connected account wrote, so your bot does not answer itself.
• comment.ad is present only for comments on paid content, so if (comment.ad) separates ad comments from organic ones.
• comment.isLive marks Instagram comments made during a live broadcast.
• comment.author.instagramProfile (follower status and count) appears only for people who have messaged the account before. Missing means unknown.

#Endpoints

#Webhook events