---
title: "Enrich one person by email or LinkedIn URL"
method: POST
path: "/people/enrich"
tags: ["People search"]
---

# Enrich one person by email or LinkedIn URL

`POST /people/enrich`

## Request

- Base URL: `https://app.pumpgtm.com/api/v1`
- URL: `https://app.pumpgtm.com/api/v1/people/enrich`
- Auth: HTTP bearer

Send exactly one of email or linkedin; an email is matched to a LinkedIn profile first. Returns { id, person, missing?, energyUsed }. person is null when nobody matches; otherwise name, title, headline, location, company {name, domain}, linkedin, x, workEmail, and connections when any are observed. find adds paid extras: x (their X account, only with public evidence it is theirs) and work_email. A requested extra that did not come back appears in missing with a reason. Energy-priced on metered workspaces (402 when exhausted, nothing charged). Request body is limited to 4 KB (413). Nothing is stored on a lead or sent.

## Headers

- `X-PumpGTM-Client` string, uuid
- `X-PumpGTM-User` string

## Request body

- object
  - `email` string: Email address to match to a LinkedIn profile. Omit when sending linkedin.
  - `linkedin` string: Public linkedin.com/in/... profile URL. Omit when sending email.
  - `find` string[]

## Response `200`

Successful response. Read outcome fields; success does not imply delivery.

- object

## Other responses

- `400`: Invalid input; for partner keys also user_header_required when the account requires X-PumpGTM-User
- `401`: Missing, invalid or revoked key
- `402`: energy_exhausted: this metered workspace has no Energy left for the action; nothing changed. Follow topUpUrl.
- `403`: Workspace mismatch, channel or feature disabled; for partner keys also enterprise_required and user_disabled
- `404`: Resource unavailable in this workspace
- `409`: Revision, identity or state conflict: { error, message } and nothing changed
- `413`: Request body larger than 4 KB
- `429`: Rate limit; respect Retry-After when provided
- `500`: internal_error: an unexpected failure on our side; retry, then contact PumpGTM
- `503`: Dependency unavailable; identity may be unknown

## Changes

- **2026-10-12** `06d2e4d0e84b`: 10 info
  - the response property `error` became required for the status `400`
  - the response property `error` became required for the status `401`
  - the response property `error` became required for the status `402`
  - the response property `error` became required for the status `403`
  - …6 more
- **2026-10-12** `08c80059d483`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/changes/people/enrich/post.md)

---

[API](https://skmtc.dev/pumpgtm/apis/pumpgtm-api.md) - [All operations](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/revisions/06d2e4d0e84b?raw)