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

# LinkedIn Find People Enrich

> Find a LinkedIn profile from name and company, then extract profile and company data and enrich with emails and phones

The LinkedIn Find People Enrich flow finds a LinkedIn profile from a person's name and company information, then extracts profile and company data and enriches with verified emails and phone numbers. This flow is ideal when you have names and company context but not the profile URL.

## Inputs

Each item in the `inputs` array can include:

| Field          | Required | Description                                                                         |
| -------------- | -------- | ----------------------------------------------------------------------------------- |
| `full_name`    | Yes\*    | Full name of the person                                                             |
| `company_name` | Yes\*    | Company name (use with `full_name` or `domain`)                                     |
| `domain`       | Yes\*    | Company domain (e.g. `acme.com`; use with `full_name` or instead of `company_name`) |
| `job_title`    | No       | Job title (helps improve profile matching)                                          |

\*Provide at least a way to identify the person and the company: e.g. `full_name` + `company_name`, or `full_name` + `domain`.

## Flow Steps

The flow executes steps in the following order:

1. **Find profile URL** (required): Finds the LinkedIn profile URL from the provided name and company/domain (and optional job title)
2. **Extract LinkedIn People** (required): Extracts detailed information from the profile
3. **Extract company information** (required): Extracts company data for the profile's current company
4. **Full enrich** (required): Enriches with contact information (emails and phone numbers). Credit costs: 2 credits for emails, 20 credits for phones, 22 credits for both.

<Tip>
  This flow runs all steps in sequence. Results are delivered asynchronously; use a callback URL or poll the run status to get outputs.
</Tip>

### Custom Data

Each item in the `inputs` array can include an optional **`custom_data`** object. The only valid key inside `custom_data` is **`meta`**. Use `meta` to attach a free-form object (e.g. your own IDs, tags, or context) that will be passed through and available in the flow output.

**Example:**

```json theme={null}
"inputs": [
  {
    ...
    "custom_data": {
      "meta": {
        "foo": "bar",
        "crm_id": 1234
      }
    }
  }
]
```

<Info>
  This feature will be improved and simplified soon without breaking changes.
</Info>

**Examples**:

<AccordionGroup>
  <Accordion title="Find and enrich with name and company">
    ```bash theme={null}
    curl --request POST \
      --url https://api.edges.run/v1/flows/linkedin-find-people-enrich/run/async \
      --header 'Content-Type: application/json' \
      --header 'X-API-Key: <your-api-key>' \
      --data '{
      "inputs": [
        {
          "full_name": "Jane Doe",
          "company_name": "Acme Inc",
          "job_title": "Head of Sales"
        }
      ],
      "identity_mode": "managed"
    }'
    ```
  </Accordion>

  <Accordion title="Find and enrich with name and domain">
    ```bash theme={null}
    curl --request POST \
      --url https://api.edges.run/v1/flows/linkedin-find-people-enrich/run/async \
      --header 'Content-Type: application/json' \
      --header 'X-API-Key: <your-api-key>' \
      --data '{
      "inputs": [
        {
          "full_name": "John Smith",
          "domain": "acme.com"
        }
      ],
      "identity_mode": "managed"
    }'
    ```
  </Accordion>

  <Accordion title="With webhook callback">
    ```bash theme={null}
    curl --request POST \
      --url https://api.edges.run/v1/flows/linkedin-find-people-enrich/run/async \
      --header 'Content-Type: application/json' \
      --header 'X-API-Key: <your-api-key>' \
      --data '{
      "inputs": [
        {
          "full_name": "Jane Doe",
          "company_name": "Acme Inc"
        }
      ],
      "identity_mode": "managed",
      "callback": {
        "url": "https://your-app.com/webhook/flow-results",
        "headers": {
          "Authorization": "Bearer your-webhook-token"
        }
      }
    }'
    ```
  </Accordion>
</AccordionGroup>

<Info>
  Instead of polling for results, you can use webhooks to receive automatic notifications when this flow completes. Learn more about [webhook payloads and handling](/api/callbacks).
</Info>


## OpenAPI

````yaml POST /flows/linkedin-find-people-enrich/run/async
openapi: 3.1.0
info:
  title: ED Automation Flows API
  description: This is the Flows API documentation for ED Automation
  version: dev
servers:
  - url: https://api.edges.run/v1
security:
  - XApiKeyAuth: []
paths:
  /flows/linkedin-find-people-enrich/run/async:
    post:
      tags:
        - flows
      summary: Run linkedin-find-people-enrich flow asynchronously
      description: Used to create and run a given flow preset.
      operationId: flowLinkedinFindPeopleEnrichAsync
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                steps:
                  type: array
                  items:
                    type: string
                    enum: []
                  description: >-
                    Optional list of step to run. If not provided, only the
                    required steps will be run.
                parameters:
                  type: object
                  properties:
                    linkedin-find-profile-url:
                      type: object
                      properties: {}
                      additionalProperties: false
                      default: {}
                    linkedin-extract-people:
                      type: object
                      properties:
                        sections:
                          type: boolean
                          title: Sections
                          default: false
                          description: >-
                            Extract sections data. When enabled, returns:
                            `education`, `languages`, `volunteer_experiences`,
                            `summary`, `company_name`, `job_title`,
                            `linkedin_company_url`.
                          x-display-widget: checkbox
                        experiences:
                          type: boolean
                          title: Experiences
                          default: false
                          description: >-
                            Extract a partial list of professional experiences:
                            includes only the user's most recent or
                            representative experiences.
                          x-display-widget: checkbox
                        skills:
                          type: boolean
                          title: Skills
                          default: false
                          description: >-
                            Extract a partial list of skills: includes only a
                            selection of the user's main competencies, not the
                            full set - this list can be empty even if the user
                            has skills listed on their profile.
                          x-display-widget: checkbox
                        highlights:
                          type: boolean
                          title: Highlights
                          default: false
                          description: >-
                            Extract highlights data. When enabled, returns:
                            `linkedin_company_url`, `connection_degree`,
                            `number_followers`, `number_connections`,
                            `linkedin_thread_id`.
                          x-display-widget: checkbox
                      additionalProperties: false
                      default: {}
                    linkedin-extract-company:
                      type: object
                      properties: {}
                      additionalProperties: false
                      default: {}
                    fullenrich-enrich-people:
                      type: object
                      properties:
                        enrich_level:
                          type: string
                          title: Enrich Level
                          default: emails
                          description: The level you want to enrich.
                          enum:
                            - emails
                            - phones
                            - emails_and_phones
                          x-display-widget: select
                      additionalProperties: false
                      default: {}
                  additionalProperties: false
                inputs:
                  type: array
                  items:
                    $ref: '#/components/schemas/FlowLinkedinFindPeopleEnrichInput'
                  minItems: 1
                  maxItems: 1000
                identity_ids:
                  type: array
                  description: >-
                    An array of Identity UUIDs linked to identities (e.g.
                    LinkedIn) used to execute the Action. You must provide at
                    least one valid UID with access to the integration. Do not
                    use account_uid values — only user_uid is supported.
                  items:
                    type: string
                    format: uuid
                  nullable: true
                  example:
                    - 44444444-4444-4444-4444-444444444444
                identity_mode:
                  type: string
                  enum:
                    - direct
                    - auto
                    - managed
                  default: direct
                  nullable: true
                  description: >-
                    If "auto", the Action will use any identities from the
                    current workspace (unless you have provided a list of
                    identity_ids). "managed" will use the Edges pool of
                    identities for an extra credit cost
                callback:
                  type: object
                  properties:
                    url:
                      type: string
                      description: >-
                        URL to send the results to. The Action will send a POST
                        request with the results to this URL. The request will
                        include a JSON body with the results of the Action.
                      nullable: true
                      pattern: ^(https?:\/\/[^\s]+)$
                      example: https://example.com/callback
                    headers:
                      type: object
                      description: Headers to include in the callback request.
                      additionalProperties:
                        type: string
                    'on':
                      type: string
                      description: >-
                        Define when you want to receive callbacks. "all" will
                        send callbacks to stream outputs, "final" will send a
                        single callback when all inputs are processed or an
                        error occured on the run.
                      enum:
                        - all
                        - final
                      default: all
                  required:
                    - url
              additionalProperties: false
              required:
                - inputs
      responses:
        '200':
          $ref: '#/components/responses/FlowAsyncResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '424':
          $ref: '#/components/responses/FailedDependency'
        '500':
          $ref: '#/components/responses/InternalServerError'
      callbacks:
        onSave:
          '{$request.body#/callback/url}':
            post:
              responses:
                '200':
                  description: Callback successfully processed
              requestBody:
                required: true
                content:
                  application/json:
                    schema:
                      type: object
                      properties:
                        flow_run:
                          type: object
                          properties:
                            flow_run_uid:
                              type: string
                              format: uuid
                              description: Run UUID
                            step_uid:
                              type: string
                              format: uuid
                              description: Output Step UUID
                              nullable: true
                            status:
                              type: string
                              enum:
                                - CREATED
                                - INVALID
                                - QUEUED
                                - SCHEDULED
                                - BLOCKED
                                - STOPPED
                                - RUNNING
                                - FAILED
                                - PARTIAL_SUCCEEDED
                                - SUCCEEDED
                              description: Flow status
                            scheduled_flow_run_uid:
                              type: string
                              format: uuid
                              description: >-
                                If the flow run is scheduled, this field
                                indicates the scheduled flow run UUID.
                              nullable: true
                          required:
                            - flow_run_uid
                            - status
                        error:
                          $ref: '#/components/schemas/APIError'
                        results_count:
                          type: integer
                          description: Number of results in the current callback
                        results:
                          type: array
                          items:
                            $ref: >-
                              #/components/schemas/FlowLinkedinFindPeopleEnrichOutput
                          description: Results of the current callback
                      required:
                        - run
              method: post
              type: path
            path: '{$request.body#/callback/url}'
components:
  schemas:
    FlowLinkedinFindPeopleEnrichInput:
      type: object
      properties:
        full_name:
          description: Full Name
          type: string
          x-primary: true
        company_name:
          description: Company Name
          type: string
        domain:
          description: Domain
          type: string
        job_title:
          description: Job Title
          type: string
        custom_data:
          type: object
          additionalProperties: true
          description: Custom data (ex-metadata)
          properties:
            meta: {}
      additionalProperties: false
      required:
        - full_name
    APIError:
      title: APIError
      description: >-
        Represents an error returned by the API. This schema defines the
        standard structure of error messages to ensure consistent error handling
        across the application.
      type: object
      properties:
        error_label:
          type: string
          nullable: true
        error_scope:
          type: string
          enum:
            - input
            - integ
            - param
            - config
          nullable: true
        error_ref:
          type: string
          examples:
            - ERR-12345
          nullable: true
        message:
          type: string
        status_code:
          type: integer
          nullable: true
        params:
          type: object
          patternProperties:
            ^[^_].*:
              anyOf:
                - type: string
                - type: number
                - type: boolean
                - type: 'null'
                - type: array
                  items:
                    type: string
          additionalProperties: false
          nullable: true
        data:
          type: object
          nullable: true
          additionalProperties: true
          description: Additional data about the error
      additionalProperties: false
    FlowLinkedinFindPeopleEnrichOutput:
      type: object
      properties:
        custom_data:
          type: object
          additionalProperties: true
          description: Custom data (ex-metadata)
          properties:
            meta: {}
        linkedin_profile_handle: {}
        first_name: {}
        last_name: {}
        full_name: {}
        birth_date: {}
        headline: {}
        summary: {}
        languages: {}
        skills: {}
        sales_navigator_profile_id: {}
        linkedin_profile_id: {}
        linkedin_profile_url: {}
        profile_country: {}
        profile_language: {}
        location: {}
        profile_image_url: {}
        job_title: {}
        education: {}
        school_name: {}
        linkedin_school_url: {}
        volunteer_experiences: {}
        number_connections: {}
        experiences: {}
        company_name: {}
        linkedin_company_url: {}
        linkedin_company_id: {}
        number_followers: {}
        linkedin_people_post_search_url: {}
        connection_degree: {}
        open_to_work: {}
        linkedin_thread_id: {}
        past_company_name: {}
        past_job_title: {}
        past_sales_navigator_company_id: {}
        past_linkedin_company_id: {}
        past_linkedin_company_url: {}
        connected_at: {}
        company_specialties: {}
        company_tagline: {}
        company_description: {}
        company_type: {}
        company_founded_on: {}
        company_website: {}
        linkedin_company_phone: {}
        sales_navigator_company_url: {}
        company_industries: {}
        company_industries_v1: {}
        company_industry: {}
        company_linkedin_job_search_url: {}
        company_followers_count: {}
        company_number_employees: {}
        company_employees_range: {}
        company_linkedin_employees_url: {}
        company_sales_navigator_employees_url: {}
        company_country: {}
        company_geographic_area: {}
        company_city: {}
        company_postal_code: {}
        company_headquarters: {}
        company_locations: {}
        company_number_of_locations: {}
        company_last_funding_investors: {}
        crunchbase_company_url: {}
        company_last_funding_date: {}
        company_last_funding_type: {}
        company_last_funding_raised: {}
        company_last_funding_currency: {}
        company_logo_url: {}
        company_domain: {}
        company_location: {}
        company_linkedin_school_id: {}
        company_linkedin_page_claimed: {}
        company_updated_at: {}
        company_affiliates: {}
        domain: {}
        emails: {}
        email: {}
        phones: {}
        email_status: {}
        email_status_normalized: {}
    BadRequest:
      title: APIError
      description: >-
        Represents an error returned by the API. This schema defines the
        standard structure of error messages to ensure consistent error handling
        across the application.
      type: object
      properties:
        error_label:
          type: string
          nullable: true
        error_scope:
          type: string
          enum:
            - input
            - integ
            - param
            - config
          nullable: true
        error_ref:
          type: string
          nullable: true
          example: ERR-12345
        message:
          type: string
        status_code:
          type: integer
          nullable: true
        params:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: number
              - type: boolean
              - type: 'null'
              - type: array
                items:
                  type: string
          nullable: true
        data:
          type: object
          nullable: true
          additionalProperties: true
          description: Additional data about the error
      additionalProperties: false
    FailedDependency:
      title: APIError
      description: >-
        Represents an error returned by the API. This schema defines the
        standard structure of error messages to ensure consistent error handling
        across the application.
      type: object
      properties:
        error_label:
          type: string
          nullable: true
        error_scope:
          type: string
          enum:
            - input
            - integ
            - param
            - config
          nullable: true
        error_ref:
          type: string
          nullable: true
          example: ERR-12345
        message:
          type: string
        status_code:
          type: integer
          nullable: true
        params:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: number
              - type: boolean
              - type: 'null'
              - type: array
                items:
                  type: string
          nullable: true
        data:
          type: object
          nullable: true
          additionalProperties: true
          description: Additional data about the error
      additionalProperties: false
    InternalServerError:
      title: APIError
      description: >-
        Represents an error returned by the API. This schema defines the
        standard structure of error messages to ensure consistent error handling
        across the application.
      type: object
      properties:
        error_label:
          type: string
          nullable: true
        error_scope:
          type: string
          enum:
            - input
            - integ
            - param
            - config
          nullable: true
        error_ref:
          type: string
          nullable: true
          example: ERR-12345
        message:
          type: string
        status_code:
          type: integer
          nullable: true
        params:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: number
              - type: boolean
              - type: 'null'
              - type: array
                items:
                  type: string
          nullable: true
        data:
          type: object
          nullable: true
          additionalProperties: true
          description: Additional data about the error
      additionalProperties: false
  responses:
    FlowAsyncResponse:
      description: Successful response
      content:
        application/json:
          schema:
            description: Successful response
            type: object
            properties:
              uid:
                type: string
                format: uuid
              workflow:
                type: object
                properties:
                  uid:
                    type: string
                  metadata:
                    type: object
                    properties:
                      account_rotation:
                        type: boolean
                        default: true
                        nullable: true
                    additionalProperties: false
                additionalProperties: false
            additionalProperties: false
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BadRequest'
    FailedDependency:
      description: Failed Dependency
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/FailedDependency'
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InternalServerError'
  securitySchemes:
    XApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````