---
title: "Enrich Contact"
method: POST
path: "/v1/contacts/enrich"
tags: ["contacts"]
---

# Enrich Contact

`POST /v1/contacts/enrich`

Find a contact's missing details from what you already know about them.

This does not read or write your workspace: it asks an enrichment provider
about the person described in the body and returns what came back, so it
spends enrichment credits. Use `POST /v1/contacts/get-and-enrich` to start
from a contact you already store, and `POST /v1/contacts` to persist the
result.

A provider that answers asynchronously returns `completed: false` with the
provider still working in `pending_provider`; retry to pick the answer up.

Requires the `contacts:write` scope on the API key.

## Request body

- EnrichContactPublicInput
  - `email` string, nullable — Email, if known.
  - `linkedin_url` string, nullable — LinkedIn profile URL, if known.
  - `first_name` string, nullable — First name, if known.
  - `last_name` string, nullable — Last name, if known.
  - `company_name` string, nullable — Employer name, if known.
  - `company_domain` string, nullable — Employer's primary domain, if known.

## Response `200`

Successful Response

- EnrichContactPublicOutput
  - `completed` boolean, required — Whether enrichment finished. `false` when a provider answers later.
  - `pending_provider` string, nullable — Provider still working on the missing fields.
  - `email` string, nullable — Email.
  - `first_name` string, nullable — First name.
  - `last_name` string, nullable — Last name.
  - `job_title` string, nullable — Job title.
  - `linkedin_url` string, nullable — LinkedIn profile URL.
  - `phone_number` string, nullable — Phone number.
  - `company_name` string, nullable — Employer name.
  - `company_domain` string, nullable — Employer's primary domain.

---

[API](https://skmtc.net/topo/apis/topo-public-api.md) · [All operations](https://skmtc.net/topo/apis/topo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topo/topo-public-api/revisions/ad6ac1d13526/schema)