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

apiProvider-backed

Track influencer

POST /api/mcp/tracked-profiles

Verify an influencer through a connected LinkedIn account and persist tracking idempotently. Following is off by default.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

linkedinAccountIdrequired

string

No description.

linkedinUrlrequired

string

No description.

shouldFollow

boolean

No description.

status

string

Use paused to save a review target without automatic polling. Omission preserves existing status or creates active tracking.

active | paused

Example

REST requestbash

curl -X POST "https://app.pipeline.help/api/mcp/tracked-profiles" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedinAccountId":"00000000-0000-4000-8000-000000000000","linkedinUrl":"https://example.com"}'

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "profile": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "workspace_id": {
          "type": "string"
        },
        "linkedin_account_id": {
          "type": "string"
        },
        "profile_type": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "workspace_id",
        "linkedin_account_id",
        "profile_type"
      ]
    },
    "followStatus": {
      "type": "string",
      "enum": [
        "not_requested",
        "success",
        "failed"
      ]
    }
  },
  "required": [
    "profile",
    "followStatus"
  ]
}

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.