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

# Connect LinkedIn Profile

> Connect with a LinkedIn user by sending a personalized message (optional).

Networking to establish relationships on LinkedIn is one of the most common use cases. This action allows you to grow your network, connect with qualified leads, and combine it with messaging to create a lead nurturing process.

<Steps>
  <Step title="Navigate to a LinkedIn Profile">
    Copy the URL from your browser.
  </Step>

  <Step title="Paste the URL">Paste it into the provided field(s).</Step>
</Steps>

A profile URL should look like this: [https://www.linkedin.com/in/marcfrancis961](https://www.linkedin.com/in/marcfrancis961).

### Inputs

<ParamField path="linkedin_profile_url" type="string" required={true} placeholder="LinkedIn People Profile URL">
  A LinkedIn Profile URL should start with
  '[https://www.linkedin.com/sales/people/](https://www.linkedin.com/sales/people/)',
  '[https://www.linkedin.com/sales/lead/](https://www.linkedin.com/sales/lead/)', '[https://www.linkedin.com/pub/](https://www.linkedin.com/pub/)' or
  '[https://www.linkedin.com/in/](https://www.linkedin.com/in/)'.
</ParamField>

### Parameters

<ParamField path="message" type="string" maxLength={300} format="textarea">
  Maximum length is 300 for a Sales Navigator account & 200 if you have a
  LinkedIn classic account. You can use placeholders like `{{ first_name }}`, `   {{ last_name }}`, and `{{ company_name }}` to personalize your message.
</ParamField>

<Info>
  If you do not use a custom message, the action will simply send the connection
  request. Leave it empty if not needed.
</Info>

### Output Fields

The following fields are returned upon successful connection:

<ResponseField>
  <Expandable title="properties">
    <ResponseField name="company_name" type="string">
      The name of the company associated with the LinkedIn profile
    </ResponseField>

    <ResponseField name="connected" type="boolean">
      Indicates if the connection was successful
    </ResponseField>

    <ResponseField name="first_name" type="string">
      The first name of the LinkedIn user
    </ResponseField>

    <ResponseField name="full_name" type="string">
      The full name of the LinkedIn user
    </ResponseField>

    <ResponseField name="job_title" type="string">
      The job title of the LinkedIn user
    </ResponseField>

    <ResponseField name="last_name" type="string">
      The last name of the LinkedIn user
    </ResponseField>

    <ResponseField name="linkedin_people_post_search_url" type="string">
      The LinkedIn post search URL for the user
    </ResponseField>

    <ResponseField name="linkedin_profile_handle" type="string">
      The LinkedIn profile handle
    </ResponseField>

    <ResponseField name="linkedin_profile_id" type="string">
      The LinkedIn profile ID
    </ResponseField>

    <ResponseField name="linkedin_profile_url" type="string">
      The LinkedIn profile URL
    </ResponseField>

    <ResponseField name="message" type="string">
      The personalized message sent with the connection request
    </ResponseField>

    <ResponseField name="pending" type="boolean">
      Indicates if the connection request is pending
    </ResponseField>

    <ResponseField name="recently_declined" type="boolean">
      Indicates if the connection request was recently declined
    </ResponseField>

    <ResponseField name="sales_navigator_profile_id" type="string">
      The Sales Navigator profile ID
    </ResponseField>
  </Expandable>
</ResponseField>

Here is the JSON schema for the output fields:

<Accordion title="Show JSON Output Schema">
  ```json
  {
    "company_name": "string",
    "connected": "boolean",
    "first_name": "string",
    "full_name": "string",
    "job_title": "string",
    "last_name": "string",
    "linkedin_people_post_search_url": "string",
    "linkedin_profile_handle": "string",
    "linkedin_profile_id": "string",
    "linkedin_profile_url": "string",
    "message": "string",
    "pending": "boolean",
    "recently_declined": "boolean",
    "sales_navigator_profile_id": "string"
  }
  ```
</Accordion>

### Specificities

<Note>
  LinkedIn accounts, especially classic accounts, typically have a limit of
  about 100 connection requests per week. This limit can vary depending on the
  account’s activity and history. If LinkedIn blocks additional connection
  requests, it’s likely that the account has reached this weekly limit.
</Note>

<Info>
  For Sales Navigator accounts, there is no fixed limit on connection requests,
  but to ensure safe usage and avoid any issues, we recommend a routine of 30
  invitations per day. This helps maintain a secure activity level and stays
  within LinkedIn’s guidelines.
</Info>