List comments on a post
Returns the comments the platform holds for one Instagram, Facebook, or Threads post, and refreshes PostZen's stored copy of the thread as a side effect. replies carries the first page of nested replies when the platform returns them cheaply — repliesHasMore says when it did not, and passing that comment's id as commentId pages through the rest. Instagram threads are only two levels deep, so a reply never carries replies of its own. Fields a platform does not report are absent rather than zero: Threads, for example, never reports per-reply like counts. Read-only and read-write API keys are accepted.
Authorization
bearerAuth PostZen API key.
In: header
Path Parameters
Post the comments belong to. Accepts a PostZen post id — resolved to the id the post was published under for accountId — or the platform's own post/media id, which is the common case because the inbox covers every post the account has, not only the ones PostZen published. Instagram and Facebook also accept a comment id here.
Query Parameters
PostZen account id of the connected Instagram, Facebook, or Threads account that owns the post.
Page size. Platform page ceilings may return fewer.
Opaque pagination cursor. Pass pagination.cursor from the previous response to fetch the next page.
Return the replies to this comment instead of the post's own comments.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/inbox/comments/string?accountId=string"{ "status": "success", "comments": [ { "id": "17912345678901234", "message": "Love this one!", "createdTime": "2026-08-17T14:22:08.000Z", "from": { "id": "17841400000000000", "name": "Jane Doe", "username": "janedoe", "isOwner": false }, "likeCount": 3, "replyCount": 1, "platform": "instagram", "url": "https://www.instagram.com/p/CxYzAbCdEfG/c/17912345678901234/", "replies": [ { "id": "17912345678901299", "message": "Thank you!", "createdTime": "2026-08-17T14:41:52.000Z", "from": { "id": "17841411111111111", "username": "postzenhq", "isOwner": true }, "platform": "instagram", "replies": [], "repliesHasMore": false, "canReply": true, "canDelete": true, "canHide": true, "isHidden": false, "parentId": "17912345678901234" } ], "repliesHasMore": false, "canReply": true, "canDelete": true, "canHide": true, "isHidden": false, "parentId": null } ], "pagination": { "hasMore": true, "cursor": "QVFIUkxsdGx..." }, "meta": { "platform": "instagram", "postId": "17895695668004550", "accountId": "k17d8s9f0a1b2c3d4e5f6g7h8i", "lastUpdated": "2026-08-18T09:15:00.000Z" }}{ "error": "The inbox supports Instagram, Facebook and Threads accounts only.", "code": "platformUnsupported", "platform": "tiktok"}{ "error": "Unauthorized"}{ "error": "Reconnect the account to grant PostZen access to its comments.", "code": "platformCapabilityMissing", "platform": "facebook"}{ "error": "That post could not be found.", "code": "postNotFound"}{ "error": "This connection needs to be reauthorized before its comments can be read.", "code": "connectionDead", "platform": "instagram"}{ "error": "(#4) Application request limit reached", "code": "4", "platform": "instagram", "platformError": "(#4) Application request limit reached"}{ "error": "Failed to create post"}{ "error": "Unsupported get request.", "code": "100", "platform": "facebook", "platformError": "Unsupported get request."}List reactions on a LinkedIn post GET
Returns the individual reactions LinkedIn holds for a post published through PostZen, plus a per-type count of the returned page. LinkedIn only, and organization (company page) posts only. The post's LinkedIn connection must hold `r_organization_social_feed`, which LinkedIn ships with its Community Management API product — reconnect the account if it was connected before company-page posting was enabled. A personal (member) post always returns `403 personalPostUnsupported`: reading a member's own comments and reactions needs `r_member_social_feed`, which LinkedIn grants to select developers only. Read-only and read-write API keys are accepted.
Comment on a post or reply to a comment POST
Publishes a comment on the post, or a reply to `commentId` when one is given. Requires a read-write API key and the account's comment-management scope; without the scope the call answers `403 platformCapabilityMissing` and nothing is sent to the platform. `attachmentUrl` is Facebook only — every other platform rejects it with `400 attachmentUnsupported`. Instagram is two levels deep, so replying to a reply is redirected to that reply's top-level parent. A Threads reply is created as a container and then published; when the publish is still pending after PostZen's internal retries the call returns `502 publishPending` and the reply may still appear on its own, so check the thread before retrying rather than posting twice.