---
title: "Enrich people by LinkedIn URL or full name + company or Lead Ids. Maximum 100 allowed"
method: POST
path: "/v1/enrich/contact"
tags: ["enrichment"]
---

# Enrich people by LinkedIn URL or full name + company or Lead Ids. Maximum 100 allowed

`POST /v1/enrich/contact`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/enrich/contact`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/enrich/contact/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- LeadEnrichmentDto
  - `linkedin_url` string[]: LinkedIn profile URLs to enrich (max 100)
  - `lead_id` number[]: Lead IDs to enrich (max 100)
  - `reveal_phone` boolean: Whether to reveal phone numbers
  - `profile_only` boolean: Save profile data only (name, job title, company, location, LinkedIn) with no contact lookup, at a reduced credit cost. Mutually exclusive with `email_type` and `reveal_phone: true` — sending either alongside it is rejected.
  - `email_type` 'work_email' | 'personal_email': Type of email to reveal. Combined with reveal_phone to decide what is revealed: work_email + reveal_phone=false reveals the work email; work_email + reveal_phone=true reveals work email and phone; personal_email + reveal_phone=false reveals the personal email; personal_email + reveal_phone=true reveals work email, personal email and phone. Ignored — and rejected — when `profile_only` is true.
  - `webhook_url` string: Webhook URL to call when enrichment completes
  - `full_name_with_company` FullNameWithCompanyDto[]: Full name + company combinations to enrich (max 100)
    - `first_name` string: First name of the person
    - `last_name` string: Last name of the person
    - `company_domain` string: Company domain (required if company_website is absent or empty)
    - `company_website` string: Company website URL (required if company_domain is absent or empty)

## Response `200`

Enrichment job created. Returns a requestId to track progress.

- object
  - `message` string
  - `payload` object
    - `requestId` string

## Other responses

- `400`: 4000: Failed to enrich leads<br><br>1001: profile_only cannot be combined with email_type or reveal_phone<br><br>

## Changes

- **2026-09-16** `a483e105b20f`: 1 info
  - added the new optional request property `profile_only`

[Operation history](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/changes/v1/enrich/contact/post.md)

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)