GET/social-inbox/conversations/{id}/items

Lists a conversation's comments and your replies, oldest first by default.

https://api.postfa.st/Auth: pf-api-keyRate limit: 300 requests per hour

Replies appear exactly once

A reply sent through /social-inbox/items/{id}/reply shows up as a single OUTBOUND item. The platform's own echo of that reply is deduplicated, so you never get two rows for one reply.

Edits, hides, and deletes performed directly on the platform sync back automatically and are reflected in text and state here.

Which id to send a reply to

The reply, private-reply, and state routes take an item id from this list, not the conversation id.

Path parameters

idstring (UUID)required

The conversation id, from /social-inbox/conversations.

Query parameters

pageintegeroptionaldefault 0

Page number (0-based indexing).

limitintegeroptionaldefault 20

Number of items per page (min 1, max 50).

orderstringoptionaldefault ASC

Sort direction by time. ASC reads the thread oldest first; DESC puts the newest comment on page 0.

ASCDESC

Response

200 OK A paginated envelope of the conversation's comments and replies.

dataItem[]required

The comments and replies on this page.

idstring (UUID)required

Item id. This is the value the reply, private-reply, and state routes take as their path parameter.

conversationIdstring (UUID)required

Conversation the item belongs to.

kindstringrequired

Item type. Always COMMENT today.

directionstringrequired

INBOUND for a comment you received, OUTBOUND for a reply you sent.

INBOUNDOUTBOUND
externalItemIdstring | nulloptional

The platform's comment id. null on an outbound reply that is still sending.

parentExternalItemIdstring | nulloptional

Platform id of the parent comment, for threading.

authorUsernamestring | nulloptional

Author's username, when the platform exposes it.

textstring | nulloptional

Comment or reply body.

statestringrequired

Moderation state on the platform, changed via the state route.

VISIBLEHIDDENDELETED
deliveryStatusstring | nulloptional

Outbound items only: how far the send got. null on inbound comments.

PENDINGSENTFAILED
authoredByUserIdstring (UUID) | nulloptional

Workspace member who sent an outbound item. null for replies sent with an API key, because keys are workspace-scoped rather than user-scoped.

platformCreatedAtISO 8601required

When the platform recorded the comment.

createdAtISO 8601required

When PostFast stored the item.

canPrivateReplyboolean | nulloptional

Instagram inbound comments: whether this comment is still eligible for /social-inbox/items/{id}/private-reply. null elsewhere.

totalCountnumberrequired

Total number of matching rows across all pages.

pageInfoobjectrequired

Pagination metadata.

hasNextPagebooleanrequired

Whether another page is available.

pagenumberrequired

1-based display number of the returned page. Requesting page=0 returns page: 1 here.

perPagenumberrequired

Page size actually applied.