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

apiProvider-backed

List company followers

POST /api/mcp/list-company-followers

Return the raw follower list for a LinkedIn company page. READ-ONLY: no campaign, table, or prospect records are created. IMPORTANT: LinkedIn restricts company followers - full list is returned only for pages your connected account ADMINISTERS (your own company or pages you manage). Arbitrary competitor pages typically return empty due to LinkedIn permissions. Accepts either a company URL (slug auto-resolves to numeric org ID) or a numeric org ID directly. Pair with add-prospects-bulk after you filter/enrich externally.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

companyUrlrequired

string

LinkedIn company page URL.

linkedinAccountIdrequired

string

Connected LinkedIn account in this workspace used to fetch.

limit

number

Max followers to return (default 500, max 5000).

Example

REST requestbash

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

Response

The operation is available, but its typed response schema has not been published yet.

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.