LinkedIn Accounts & Licences

​

Handling LinkedIn Accounts

​

Adding a New User

To automate LinkedIn actions, you must first add a user on Captain Data using the API Endpoint POST Create or Update User.

Example Request Body:

{
  "email": "[email protected]",
  "full_name": "John Doe",
  "country": "FR"
}

You can use any ISO 3166-1 alpha-2 country code except the following:

"MG","RE","CI", "NA", "CV", "MU", "HN", "UY", "XK", "GN", "UA", "BB", "PF", "QA", "KY", "LY", "LB", "VE", "UG", "CH", "PK"

These country codes are restricted to ensure compliance with platform requirements and maintain secure automation.

​

Linking LinkedIn Accounts to Users

After adding a user, you will connect an integration account in order to link the LinkedIn account to the user using the API Endpoint POST - Add or Update an Integration Account.

The core of the LinkedIn integration are the cookies, which allow us to perform the desired actions on LinkedIn.

Here’s an example account payload, using the previously created user_uid:

{
  "account": {
    "name": "Name of the account",
    "cookies": {
      "li_at": "YOUR_SESSION_COOKIE",
      "li_a": "If the account is a Sales Navigator one"
    },
    "user_uid": "xxxxx-xxxxx-xxxxx-xxxxx"
  }
}

If you wan to create a Shared LinkedIn Account, add the following to your request:

{
  "shared_account": true
}

​

Best Practices for LinkedIn Automation

VPN and Country Settings

• Ensure the country in Captain Data matches your login location on LinkedIn.
• Match your VPN’s country with Captain Data, or disconnect the VPN while logging in.

Managing Chrome Sessions

• Use Captain Data’s Chrome Extension to automatically sync cookies.
• For multiple LinkedIn accounts, you must create separate Chrome sessions:
  • Click your Chrome profile icon > Add a new profile.
  • Name it according to the LinkedIn account (e.g., “Account B”).
  • Log in to Captain Data and LinkedIn within this new session.

​

Refreshing Cookies

Cookies need refreshing if:

• You log out of LinkedIn
• LinkedIn expires or changes cookies
• LinkedIn restricts the account due to excessive activity

Regular activity and following Smart Limits guidelines help prevent restrictions.

​

How to refresh cookies via API

In order to refresh accounts via API you need to use the POST - Add or Update an Integration Account by passing li_a and/or li_at cookie values.

Here’s a code example for a Chrome Extension that runs in the background using alarms:

/**
 * Alarm to update cookies every X minutes.
 */
chrome.alarms.onAlarm.addListener(() => {
  // Ensure updateTokensHandle() is defined elsewhere in your code
  return updateTokensHandle();
});

// Set up the alarm when the extension is installed
chrome.runtime.onInstalled.addListener(async ({ reason }) => {
  const periodDurationMinutes = 120; // Every 2 hours

  // Create an alarm that will trigger every `periodDurationMinutes`
  await chrome.alarms.create("updateToken", {
    periodInMinutes: periodDurationMinutes,
  });

  console.log(
    "Alarm created to update token every " + periodDurationMinutes + " minutes"
  );
});

​

Smart Limits to Prevent Account Restrictions

​

LinkedIn Licenses Compatibility

Captain Data supports various LinkedIn licenses, each with unique features and limitations. Below is a breakdown of how each license integrates with Captain Data:

Today Captain Data handles LinkedIn Basic, LinkedIn Premium Business, and Sales Navigator Core which are defined as levels in the LinkedIn integration.

​

Troubleshooting LinkedIn Login Errors

When connecting a LinkedIn account (via cookies or native login), you may encounter various errors. Below is a guide to the most common error cases, their meanings, and how to resolve them.

​

Common Error Cases

​

Notes & Recommendations

• Google Login: If your LinkedIn account uses Google login, you must set a password on LinkedIn (via “Forgot password”) to use native login.
• IP/Location Issues: Many errors are related to IP allocation or location mismatches. Make sure your timezone and country settings in Captain Data match your actual login location.
• Challenge/2FA: If you receive a challenge (SMS, email, in-app), complete it promptly. If it expires, restart the login process.
• Contact Support: For persistent or unclear errors, contact support and provide your identity_uid for faster resolution.

For more details, see the LinkedIn authentication and checkpoint API documentation.

By following this guide, you can safely automate LinkedIn activities with Captain Data, ensuring stable sessions and avoiding platform restrictions.

For further assistance, feel free to reach out to our support team at [email protected] 🙌