> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Follow / Unfollow

> Follow or unfollow a member profile or a company page.

## Overview

Follows a person (their posts appear in the account's feed, without a connection request) or a company page, or stops following them. Pass `profile_url` for a person, `company_url` for a page. Unfollowing a connection keeps the connection; only their posts leave the feed.

<Note>This endpoint consumes **1 credit** per request. Ignore this if you're on per-seat pricing: usage is unlimited.</Note>

## Request

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication.
</ParamField>

<ParamField body="account_id" type="string" required>
  The unique identifier of the account to use.
</ParamField>

<ParamField body="action" type="string" required>
  `"follow"` or `"unfollow"`. Same params for both.
</ParamField>

<ParamField body="params" type="object" required>
  <Expandable title="params properties">
    <ParamField body="profile_url" type="string">
      The person to follow: profile URL (`https://www.linkedin.com/in/john-doe/`), public slug (`john-doe`), member id (`ACoAA…`) or `urn:li:fsd_profile:…`. **Required to follow a person.**
    </ParamField>

    <ParamField body="company_url" type="string">
      The company page to follow: URL (`https://www.linkedin.com/company/google/`) or slug (`google`). **Required to follow a page, unless `company_id` is given.**
    </ParamField>

    <ParamField body="company_id" type="string">
      Numeric LinkedIn company id, as an alternative to `company_url`.
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="following" type="boolean">
      `true` after `follow`, `false` after `unfollow`.
    </ResponseField>

    <ResponseField name="profile_id" type="string">
      Member id of the followed person (`ACoAA…`). Person only.
    </ResponseField>

    <ResponseField name="profile_urn" type="string">
      `urn:li:fsd_profile:…` of the followed person. Person only.
    </ResponseField>

    <ResponseField name="follower_count" type="integer">
      Follower count of the person or page as LinkedIn reports it after the action.
    </ResponseField>

    <ResponseField name="company_id" type="string">
      Numeric id of the followed company. Page only.
    </ResponseField>

    <ResponseField name="company_urn" type="string">
      `urn:li:fsd_company:…` of the followed company. Page only.
    </ResponseField>

    <ResponseField name="name" type="string">
      Company name. Page only, when the page was given as `company_url`.
    </ResponseField>

    <ResponseField name="universal_name" type="string">
      Company slug. Page only, when the page was given as `company_url`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  <Expandable title="metadata properties">
    <ResponseField name="action" type="string">The action that was performed (`"follow"` or `"unfollow"`).</ResponseField>
    <ResponseField name="account_id" type="string">The account ID used for the request.</ResponseField>
    <ResponseField name="credits_consumed" type="integer">Number of credits consumed (1).</ResponseField>
    <ResponseField name="timestamp" type="string">ISO 8601 timestamp of the response.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 — Person theme={null}
  {
    "success": true,
    "data": {
      "following": true,
      "profile_id": "ACoAAGOTIYIBlqheYWb-Mm6ygh4ErjKMId2CNMo",
      "profile_urn": "urn:li:fsd_profile:ACoAAGOTIYIBlqheYWb-Mm6ygh4ErjKMId2CNMo",
      "follower_count": 44
    },
    "metadata": {
      "action": "follow",
      "account_id": "your-account-id",
      "credits_consumed": 1,
      "timestamp": "2026-10-12T14:02:11Z"
    }
  }
  ```

  ```json 200 — Company page, unfollow theme={null}
  {
    "success": true,
    "data": {
      "following": false,
      "company_id": "1441",
      "company_urn": "urn:li:fsd_company:1441",
      "name": "Google",
      "universal_name": "google",
      "follower_count": 42498394
    },
    "metadata": {
      "action": "unfollow",
      "account_id": "your-account-id",
      "credits_consumed": 1,
      "timestamp": "2026-10-12T14:02:11Z"
    }
  }
  ```

  ```json 400 — Nothing to follow theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_PARAMS",
      "message": "profile_url, company_url or company_id is required"
    },
    "metadata": {
      "action": "follow",
      "credits_consumed": 0,
      "timestamp": "2026-10-12T14:02:11Z"
    }
  }
  ```

  ```json 400 — Unknown profile theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_PARAMS",
      "message": "Profile not found"
    },
    "metadata": {
      "action": "follow",
      "credits_consumed": 1,
      "timestamp": "2026-10-12T14:02:11Z"
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.