Webhook enrich_people

Enrich People Result

When the people enrichment request is completed, the results will be sent to you via a POST request to the url you provided in the `Enrich people` endpoint.

This payload is POSTed to the webhook_url you provided when triggering the endpoint. Return a 2xx response so the API knows delivery succeeded.

Payload application/json

List of enriched people
Array of PublicPersonWithUniqueId
Enriched person
id string Required
Internal ocean id of the person
domain string Required
Domain of the company the person is working for
name string
Full name of the person
firstName string
First name of the person
lastName string
Last name of the person
country string
Country code of the person
state string
State code of the person
location string
Location of the person
linkedinUrl string
Link to the linkedin profile of the person
List of seniorities computed from the job title of the person
Array of Seniority
enum
"Owner""Founder""Board Member""C-Level""Partner""VP""Head""Director""Manager""Other""Senior""Professional""Entry""Intern"
List of departments computed from the job title of the person
Array of Department
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other""Education"
Sub-departments computed from the job title of the person. A sub-department is a narrower version of a department, for example software development within engineering. The order does not pair up with `departments`, so use /v2/data-fields to see which department a sub-department belongs to.
Array of SubDepartment
enum
"Accounting and audit""Banking and credit""Financial advisory and investment""Corporate finance & control""Accounting and Finance - unspecified""Board membership""Board - unspecified""Administrative support""Business Support - unspecified""Customer service & support""Call centre & contact centre""Customer success""Customer Relations - unspecified""Graphic and visual design""Art direction and creative direction""Photography and video production""Specialist and applied design""UX & product design""Design - unspecified""Content, writing & editorial""Editorial Personnel - unspecified""Software development""Data, analytics & machine learning""QA & software testing""Mechanical & manufacturing engineering""Civil, structural & quantity surveying""Electrical & automation engineering""IT infrastructure, cloud & DevOps""Architecture & solutions design""Field & laboratory technical services""General engineering""Security engineering""Network & infrastructure""Technical support & helpdesk""Systems analysis & data management""IT management & strategy""Information security""Information technology - unspecified""Engineering - unspecified""Business ownership & entrepreneurship""Founder/Owner - unspecified""Nursing""Physicians & surgeons""Pharmacy, therapy & allied health""Direct care & patient support""Healthcare administration & coordination""Healthcare - unspecified""Recruiting & talent acquisition""HR business partnering & operations""Learning & development""Health, safety & environment""HR - unspecified""Attorney & legal practice""Legal support & administration""Contracts & procurement""Compliance & regulatory affairs""Legal - unspecified""Consulting & advisory""Operational unit management""Executive leadership""Management - unspecified""Production operations""Maintenance & repair""Skilled trades & craft production""Manufacturing - unspecified""Brand, digital & growth marketing""Social media & community""Marketing and Advertising - unspecified""Project & programme management""General operations management""Business analysis & process improvement""Aviation & flight operations""Food & beverage production""Hospitality & front-of-house""Facilities, maintenance & cleaning""Construction & field operations""Operations - unspecified""Communications, PR & events""PR and Communications - unspecified""Procurement and purchasing""Procurement - unspecified""Product management""Product ownership""Product operations & support""Product strategy & innovation""Product - unspecified""Quality control & assurance""Quality Control - unspecified""Research & science""R&D - unspecified""Retail & store sales""Account management""Business development""Real estate""Field & territory sales""Inside sales & telemarketing""Commercial & B2B sales""Relationship & client management""Sales engineering & technical sales""Merchandising & brand promotion""General & direct sales""Sales - unspecified""Security & protective services""Security - unspecified""Warehouse & logistics""Driving & transportation""Supply Chain - unspecified""Student or trainee""Not currently employed""General or unspecialised worker""Other - unspecified""K-12 teaching""Higher education faculty""Classroom & learning support""Training & instructional design""Student guidance & support services""School leadership & administration""Education - unspecified"
photo string
Link to the person's profile picture on LinkedIn
jobTitle string
Job title of the person
jobTitleEnglish string
English translation of the person's job title
currentJobDescription string
Current job description of the person
List of experiences of the person
Array of Experience
domain string
Domain of the company the person is working for
jobTitle string
Job title of the person
dateFrom string
Start date of the experience
dateTo string
End date of the experience
description string
Description of the experience
linkedinCompanyHandle string
Linkedin handle of the company the person is working for
summary string
Summary of the person
Skills of the person
Array of string
Phone numbers of the person
Phone numbers
Array of string
status enum Required
Status of the phone numbers: verified or not found
"verified""notFound""inProgress"
Email of the person
address string Required
Email address
status enum Required
Status of the address: verified, catchAll or guessed
"verified""guessed""catchAll""notFound"
List of inferred email addresses for the person. This is only available for enterprise subscriptions.
Array of string
updatedAt string
When has the person data been updated for the last time
connectionsCount integer
Number of LinkedIn connections of the person
followersCount integer
Number of LinkedIn followers of the person
headline string
Headline of the person
uniqueId string Required
A unique identifier provided by the user for a person. This ID will be included in the webhook response together with the enriched person data, allowing the user to match the response to the original request.
Status of the person enrichment
enum
"Success""Not enough data""Not found""Too many matches"
Status of the whole enrichment batch: `"Completed`" if all people were processed, `"Incomplete`" if enrichment failed because of time out.
enum
"Completed""Incomplete"
creditsUsed number Required
Number of credits charged for this request.