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

# Find connections

> Returns mutual connections between your LinkedIn account and a target lead via LinkedIn Sales Navigator. Results are 1st-degree connections you share with the target. Requires a connected LinkedIn account with Sales Navigator access.

Find mutual connections between your LinkedIn account and a target lead via LinkedIn Sales Navigator.
Returns 1st-degree connections you share with the target.

### Use Cases

* Find mutual connections with a prospect before reaching out
* Discover shared alumni, colleagues, or group members with a target

## Notes

* Requires a connected LinkedIn account with Sales Navigator access
* Accepts public LinkedIn URLs, Sales Nav URLs, or internal URNs


## OpenAPI

````yaml POST /intents/leads/connections
openapi: 3.0.1
info:
  title: Pipecorn Accounts API
  description: Pipecorn Accounts API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://app.pipecorn.com/api/v2/
security:
  - defaultApiKey: []
paths:
  /intents/leads/connections:
    post:
      summary: Find connections with a LinkedIn lead
      description: >-
        Returns mutual connections between your LinkedIn account and a target
        lead via LinkedIn Sales Navigator. Results are 1st-degree connections
        you share with the target. Requires a connected LinkedIn account with
        Sales Navigator access.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - linkedin_profile_url
              properties:
                linkedin_profile_url:
                  type: string
                  format: uri
                  description: >-
                    LinkedIn profile URL of the target person. Accepts public
                    profile URLs (`/in/...`), Sales Navigator URLs
                    (`/sales/lead/...`), or internal LinkedIn URNs.
                  example: https://www.linkedin.com/in/john-doe
      responses:
        '200':
          description: Connections found successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    description: Total number of connections found
                    example: 3
                  connections:
                    type: array
                    description: List of mutual 1st-degree connections with the target
                    items:
                      type: object
                      properties:
                        first_name:
                          type: string
                          description: First name of the connection
                          example: Jane
                        last_name:
                          type: string
                          description: Last name of the connection
                          example: Doe
                        full_name:
                          type: string
                          description: Full name of the connection
                          example: Jane Doe
                        degree:
                          type: integer
                          description: >-
                            LinkedIn connection degree with the authenticated
                            user (always 1)
                          example: 1
                        profile_urn:
                          type: string
                          description: LinkedIn Sales Navigator profile URN
                          example: >-
                            urn:li:fs_salesProfile:(ACwAABD5FBQ,NAME_SEARCH,vIqI)
                        sales_navigator_url:
                          type: string
                          format: uri
                          description: URL to the connection's Sales Navigator profile
                          example: >-
                            https://www.linkedin.com/sales/lead/ACwAABD5FBQ,NAME_SEARCH,vIqI/
                        linkedin_url:
                          type: string
                          format: uri
                          nullable: true
                          description: >-
                            URL to the connection's public LinkedIn profile
                            (null if not available)
                          example: https://www.linkedin.com/in/jane-doe/
                        profile_picture_url:
                          type: string
                          format: uri
                          nullable: true
                          description: >-
                            URL to the connection's profile picture (null if not
                            available)
                          example: https://media.licdn.com/dms/image/...
                        current_position:
                          type: object
                          nullable: true
                          description: Current job position of the connection
                          properties:
                            title:
                              type: string
                              nullable: true
                              description: Current job title
                              example: VP Sales
                            company:
                              type: string
                              nullable: true
                              description: Current company name
                              example: Acme Corp
        '400':
          description: Bad request — missing required `linkedin_profile_url`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                missing_keys:
                  value:
                    error: 400
                    message: 'Missing required keys: linkedin_profile_url'
        '401':
          description: Unauthorized — missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: >-
            Unprocessable — LinkedIn account not connected or Sales Navigator
            credentials expired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                no_linkedin_credentials:
                  value:
                    error: 422
                    message: >-
                      LinkedIn account not found. Please connect your LinkedIn
                      account.
                no_sales_nav:
                  value:
                    error: 422
                    message: Sales Navigator credentials not found or expired.
        '429':
          description: Too many requests — LinkedIn rate limit reached
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    defaultApiKey:
      type: apiKey
      in: header
      name: X-API-KEY

````