Skip to main content
POST
/
flows
/
linkedin-people-enrich
/
run
/
async
Run linkedin-people-enrich flow asynchronously
curl --request POST \
  --url https://api.edges.run/v1/flows/linkedin-people-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "inputs": [
    {
      "linkedin_profile_url": "<string>",
      "custom_data": {
        "meta": "<unknown>"
      }
    }
  ],
  "steps": [
    "linkedin-extract-people-skills"
  ],
  "parameters": {
    "linkedin-extract-people": {},
    "linkedin-extract-people-skills": {},
    "linkedin-extract-people-experiences": {},
    "linkedin-extract-people-educations": {},
    "linkedin-extract-company": {},
    "fullenrich-enrich-people": {}
  },
  "identity_ids": [
    "44444444-4444-4444-4444-444444444444"
  ],
  "identity_mode": "direct",
  "callback": {
    "url": "https://example.com/callback",
    "headers": {},
    "on": "all"
  }
}
'
{
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow": {
    "uid": "<string>",
    "metadata": {
      "account_rotation": true
    }
  }
}
The LinkedIn People Enrich flow extracts detailed information from a LinkedIn profile, then optionally enriches it with company data, full experiences, full skills, and contact information. You can get a complete enrichment in a single API call, aggregating People, Company, Experiences, and Skills data. This flow is ideal for profile enrichment and contact discovery.

​
Inputs

Each item in the inputs array can include:
FieldRequiredDescription
linkedin_profile_urlYesLinkedIn profile URL (e.g. https://www.linkedin.com/in/example)
job_titleNoJob title to pass through with the input (e.g. for your own tracking or matching)

​
Flow Steps

The flow executes steps in the following order:
  1. linkedin-extract-people (required): Extracts detailed information from the specified LinkedIn profile
    • linkedin-extract-people-experiences: Extracts full experiences data from the profile
    • linkedin-extract-people-skills: Extracts full skills data from the profile
    • linkedin-extract-people-educations: Extracts education data from the profile
    • linkedin-extract-company: Extracts company information for the profile’s current company
    • fullenrich-enrich-people: Enriches the profile with contact information (emails and/or phone numbers). Credit costs: 2 credits for emails, 20 credits for phones, 22 credits for both.
Outputs from Extract LinkedIn People Skills, Extract LinkedIn People Experiences, and Extract LinkedIn People Educations take precedence over those of linkedin-extract-people when present.
When using the optional linkedin-extract-people-experiences or linkedin-extract-people-skills steps: do not enable the skills and experiences parameters on the required linkedin-extract-people step. If they are enabled, the data from the mandatory step will take priority and override the outputs from the optional experiences and skills steps.
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:
"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: 
curl --request POST \
  --url https://api.edges.run/v1/flows/linkedin-people-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <your-api-key>' \
  --data '{
  "inputs": [
    {
      "linkedin_profile_url": "https://www.linkedin.com/in/example-profile",
      "job_title": "Software Engineer"
    }
  ],
  "identity_mode": "managed"
}'

curl --request POST \
  --url https://api.edges.run/v1/flows/linkedin-people-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <your-api-key>' \
  --data '{
  "steps": [
    "linkedin-extract-people-experiences",
    "linkedin-extract-people-skills",
    "linkedin-extract-company",
    "fullenrich-enrich-people"
  ],
  "parameters": {
    "linkedin-extract-people": {
      "sections": true,
      "highlights": true
    },
    "fullenrich-enrich-people": {
      "enrich_level": "emails_and_phones"
    }
  },
  "inputs": [
    {
      "linkedin_profile_url": "https://www.linkedin.com/in/example-profile"
    }
  ],
  "identity_ids": ["44444444-4444-4444-4444-444444444444"]
}'
When using the optional linkedin-extract-people-experiences and linkedin-extract-people-skills steps, leave experiences and skills disabled (or omit them) in the linkedin-extract-people parameters. Otherwise the mandatory step’s data takes priority and overrides the full data from the optional steps.
curl --request POST \
  --url https://api.edges.run/v1/flows/linkedin-people-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <your-api-key>' \
  --data '{
  "inputs": [
    {
      "linkedin_profile_url": "https://www.linkedin.com/in/example-profile"
    }
  ],
  "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.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
inputs
object[]
required
Required array length: 1 - 1000 elements
​
steps
enum<string>[]

Optional list of step to run. If not provided, only the required steps will be run.

Available options:
linkedin-extract-people-skills,
linkedin-extract-people-experiences,
linkedin-extract-people-educations,
linkedin-extract-company,
fullenrich-enrich-people
​
parameters
object
​
identity_ids
string<uuid>[] | null

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.

Example:
["44444444-4444-4444-4444-444444444444"]
​
identity_mode
enum<string> | null
default:direct

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

Available options:
direct,
auto,
managed
​
callback
object

Response

Successful response

Successful response

​
uid
string<uuid>
​
workflow
object