Engage

List Engage inbox posts

Live-syncs comments from LinkedIn for your recent published posts, then returns the Engage inbox post list with unanswered counts. Unlike analytics, this is always a fresh LinkedIn read.

GET/api/public/engage/posts

cURLGET /api/public/engage/posts

curl "https://postiv.ai/api/public/engage/posts" \
  -H "Authorization: Bearer pk_postiv_..."

200Response

{
  "success": true,
  "posts": [
    {
      "postUrn": "urn:li:share:123",
      "unansweredCount": 2,
      "postPreview": "I lost my biggest client..."
    }
  ],
  "unreadCount": 2,
  "freshness": "live"
}

Authorization

Requires an organization API key with the engage:read scope, sent as Authorization: Bearer or x-api-key.

Query parameters

statusFilterstring

all (default) or unanswered.

integrationIdinteger

Only posts authored by this LinkedIn profile/page.

maxPostsinteger

How many recent posts to live-sync (default 20, max 30).

Response

Fresh inbox posts.

posts[]array

postUrn, unansweredCount, authorName, postPreview, etc.

freshnessstring

Always "live" after a successful sync.

replyProfiles[]array

Profiles/pages you can reply as (integrationId, name, isOrgPage).

Errors

422	linkedin_cmm_required: no active CMM-connected LinkedIn profile

Good to know

MCP twin: list_engage_posts.