Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

List tracked posts

GET /api/mcp/engagement/tracked-posts

List workspace-scoped posts discovered from tracked LinkedIn profiles. Read-only and deterministic.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

trackedProfileId

string

Optional tracked profile UUID filter.

commentStatus

string

No description.

limit

integer

Maximum posts to return, from 1 to 100. Defaults to 20.

Example

REST requestbash

curl -X GET "https://app.pipeline.help/api/mcp/engagement/tracked-posts" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "tracked_profile_id": {
            "type": "string"
          },
          "workspace_id": {
            "type": "string"
          },
          "linkedin_account_id": {
            "type": "string"
          },
          "linkedin_post_id": {
            "type": "string"
          },
          "post_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "post_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "comment_status": {
            "type": "string"
          },
          "discovered_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "tracked_profile_id",
          "workspace_id",
          "linkedin_account_id",
          "linkedin_post_id",
          "comment_status",
          "discovered_at"
        ]
      }
    }
  },
  "required": [
    "data"
  ]
}

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.