> ## 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 Domain Employees Enrich
> Find a company by domain, then search and enrich its employees
The LinkedIn Domain Employees Enrich flow finds a LinkedIn company page from a domain or company name, then searches for employees and optionally enriches them with profile and contact information. This flow is ideal for finding and enriching employee lists from company domains.
## Flow Steps
The flow executes steps in the following order:
1. **Find LinkedIn Company URL** (required): Finds the LinkedIn company page from a domain or company name
2. **Search Company Employees** (required): Searches for employees of the company
3.
* **`linkedin-extract-people`**: Extracts detailed LinkedIn profile information (sections, experiences, skills, highlights)
* **`linkedin-extract-company`**: Extracts company information for each profile's current company
* **`fullenrich-enrich-people`**: Enriches profiles with contact information (emails and/or phone numbers). Credit costs: 2 credits for emails, 20 credits for phones, 22 credits for both.
Some steps have dependencies on other steps. For example, `fullenrich-enrich-people` requires profile data from previous steps. If you include a step that has dependencies, the required steps will be automatically activated even if you don't explicitly include them in your request body.
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
}
}
}
]
```
We currently require **`meta`** as a workaround to ship this capability; a more solid implementation will follow soon without breaking changes.
**Examples**:
```bash theme={null}
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-domain-employees-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: ' \
--data '{
"inputs": [
{
"domain": "example.com"
}
],
"identity_mode": "managed"
}'
```
```bash theme={null}
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-domain-employees-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: ' \
--data '{
"steps": [
"Extract LinkedIn Company Profile",
"Search LinkedIn Company Employees",
"Extract LinkedIn People Profile",
"Full enrich people"
],
"parameters": {
"linkedin-search-company-employees": {
"max_results": 1000,
"title": "Sales Manager",
"network": "F",
"geo_urn": "101240143"
},
"linkedin-extract-people": {
"sections": true,
"experiences": true,
"skills": true,
"highlights": true
},
"fullenrich-enrich-people": {
"enrich_level": "emails_and_phones"
}
},
"inputs": [
{
"domain": "example.com"
}
],
"identity_ids": ["44444444-4444-4444-4444-444444444444"]
}'
```
```bash theme={null}
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-domain-employees-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: ' \
--data '{
"inputs": [
{
"domain": "example.com"
}
],
"identity_mode": "managed",
"callback": {
"url": "https://your-app.com/webhook/flow-results",
"headers": {
"Authorization": "Bearer your-webhook-token"
}
}
}'
```
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).
## OpenAPI
````yaml POST /flows/linkedin-domain-employees-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-domain-employees-enrich/run/async:
post:
tags:
- flows
summary: Run linkedin-domain-employees-enrich flow asynchronously
description: Used to create and run a given flow preset.
operationId: flowLinkedinDomainEmployeesEnrichAsync
parameters: []
requestBody:
content:
application/json:
schema:
type: object
properties:
steps:
type: array
items:
type: string
enum:
- linkedin-extract-people
- linkedin-extract-company
- fullenrich-enrich-people
description: >-
Optional list of step to run. If not provided, only the
required steps will be run.
parameters:
type: object
properties:
linkedin-find-company-url:
type: object
properties: {}
additionalProperties: false
default: {}
linkedin-search-company-employees:
type: object
properties:
title:
type: string
title: Job Title
default: ''
description: Filter employees by title.
x-display-widget: textbox
network:
type: string
title: Connections (network)
enum:
- null
- F
- S
- O
default: null
description: 'Filter employees by network: 1st, 2nd or 3rd.'
x-display-widget: select
geo_urn:
type: string
title: Geography
default: ''
description: >-
Filter employees by geography. Sales
Navigator/LinkedIn numbers describing the location
you want to search people in. For example 'Paris,
Ile-de-France' is 101240143, 'Greater Lyon Area' is
90009674 and 'France' is 105015875. To cumulate
several location, you must seprate each location
with a comma.
x-display-widget: textbox
industry:
type: string
title: Industry
default: ''
description: Enter an industry.
x-display-widget: textbox
keywords:
type: string
title: Keywords
default: ''
description: Filter employees by keywords.
x-display-widget: textbox
max_results:
type: integer
title: Maxmium number of employees
default: 1000
maximum: 1000
description: >-
Maximum number of employees to extract per input
(company profile).
xAutoPaginate: true
x-display-widget: numeric
past_company:
type: string
title: Past Company
default: ''
description: >-
Precise you search with the name of the past
company.
x-display-widget: textbox
school_filter:
type: string
title: School Filter
default: ''
description: >-
Filter your search with a school name (e.g.
Harvard).
x-display-widget: textbox
contact_interest:
type: string
title: Contact Interest
enum:
- null
- proBono
- boardmember
default: null
description: Filter employees interests
x-display-widget: select
profile_language:
type: string
title: Profile Language
default: ''
description: The language of the profile you're looking for.
x-display-widget: textbox
additionalProperties: false
default: {}
linkedin-extract-people:
type: object
properties:
sections:
type: boolean
title: Sections
default: true
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/FlowLinkedinDomainEmployeesEnrichInput
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/FlowLinkedinDomainEmployeesEnrichOutput
description: Results of the current callback
required:
- run
method: post
type: path
path: '{$request.body#/callback/url}'
components:
schemas:
FlowLinkedinDomainEmployeesEnrichInput:
type: object
properties:
address:
description: Address of the company
type: string
custom_data:
type: object
additionalProperties: true
description: Custom data (ex-metadata)
properties:
meta: {}
anyOf:
- type: object
required:
- domain
properties:
domain:
description: Domain of the company
type: string
x-primary: true
x-required-variations:
- company_name
- type: object
required:
- company_name
properties:
company_name:
description: Name of the company
type: string
additionalProperties: false
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
FlowLinkedinDomainEmployeesEnrichOutput:
type: object
properties:
custom_data:
type: object
additionalProperties: true
description: Custom data (ex-metadata)
properties:
meta: {}
company_name: {}
company_specialties: {}
company_tagline: {}
linkedin_company_id: {}
company_description: {}
company_type: {}
company_founded_on: {}
linkedin_company_url: {}
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: {}
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: {}
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: {}
current_company: {}
current_title: {}
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
````