---
title: "Enrich Contact Preview"
method: POST
path: "/api/enrich-contact-preview"
tags: ["Client Enrichment"]
---

# Enrich Contact Preview

`POST /api/enrich-contact-preview`

Enrich a contact without saving to the database.

This endpoint is designed for the ClientForm page where contacts may not
be saved yet. It runs the contact enrichment agent and returns the
enriched data for the frontend to populate form fields.

Unlike /enrich-contact, this does NOT:
- Require a contact_id
- Save any data to the database
- Create entity_links

It simply returns the enriched data for preview/form population.

## Query parameters

- `user_id` string
- `org_id` string

## Request body

- ContactPreviewEnrichmentRequest — Request model for contact enrichment preview (no database save).
  - `email` string, required — Contact's email address (required)
  - `name` string, nullable — Contact's name
  - `phone` string, nullable — Contact's phone number
  - `job_title` string, nullable — Contact's job title
  - `company_name` string, nullable — Company name for context

## Response `200`

Successful Response

- ContactPreviewEnrichmentResponse — Response model for contact enrichment preview.
  - `success` boolean, required
  - `name` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `job_title` string, nullable
  - `company` string, nullable
  - `location` string, nullable
  - `seniority` string, nullable
  - `industry` string, nullable
  - `headline` string, nullable
  - `links` object[]
  - `enriched_fields` string[]
  - `error` string, nullable

## Other responses

- `422` — Validation Error

---

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