Inbox

List inbox conversations

List Instagram and Facebook Page DM conversations. Threads has no DMs. Requires posts:read, a Pro plan or higher, and viewer workspace access.

get/api/v1/inbox/conversations

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/inbox/conversations
  • Auth: HTTP bearer

Query parameters

workspace_idstring

Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.

account_idinteger

Repeatable social account ID filter.

platform'instagram' | 'facebook' | 'threads'

Repeatable platform filter. Threads has no DMs.

filter'all' | 'unread' | 'starred' | 'archived'
searchstring
limitinteger
offsetinteger

Response

Conversations listed successfully

conversationsobject[]
totalinteger
hasMoreboolean
workspaces_searchedstring[]

Workspace IDs actually searched for this request.

Changes

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