People search

Enrich one person by email or LinkedIn URL

Changed on

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.

post/people/enrich

Request

  • Base URL
    https://app.pumpgtm.com/api/v1
  • Auth
    HTTP bearer

Headers

X-PumpGTM-Clientstring uuid

Optional authorized Team workspace ID from GET /workspaces. Omit to use the key's home workspace.

X-PumpGTM-Userstring

Enterprise partners: act on one end user's workspace using the partner key (a workspace or Team owner key; a personal key gets 403 partner_key_required). Requires the outreach capability on the partner account (403 enterprise_required otherwise); the user must exist and be active (404 user_not_found, 403 user_disabled). Never send it together with X-PumpGTM-Client (400 invalid_request). Omit to use the key's own workspace, unless the partner account has rest.requireUserHeader on (PATCH /api/partner/v1/account): then any /api/v1 request without it is 400 user_header_required and nothing runs.

Request body

emailstring

Email address to match to a LinkedIn profile. Omit when sending linkedin.

linkedinstring

Public linkedin.com/in/... profile URL. Omit when sending email.

findstring[]

Response

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

object required

Changes

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      endpoint added