Inbox

List direct message conversations

Returns the Instagram direct message threads PostZen holds for the accounts this key can reach, newest activity first, and refreshes that stored copy from the platform as a side effect (throttled per account, so a tight polling loop costs nothing extra). meta reports which accounts could not be refreshed; their stored threads are still returned. Read-only and read-write API keys are accepted.

get/v1/inbox/conversations

Request

  • Base URL: https://api.postzen.dev
  • URL: https://api.postzen.dev/v1/inbox/conversations
  • Auth: HTTP bearer

Query parameters

accountIdstring

Restrict the read to one connected account. Omitted, every Instagram account the key can reach is queried.

profileIdstring

Restrict the read to accounts on one profile.

platform'instagram'

Restrict the read to one platform. Direct messages cover Instagram only; any other value is a validation error.

status'active' | 'archived'

Return only active or only archived threads. Archive state is PostZen-local.

sortOrder'asc' | 'desc'

Order by updatedTime.

limitinteger

Page size.

cursorstring

Opaque pagination cursor. Pass pagination.nextCursor from the previous response.

Response

Conversations returned.

Changes

No recorded changes to this operation across all 1 revision of this API.