---
title: "Create enrichment"
method: POST
path: "/v1/enrichments"
tags: ["Enrichment"]
---

# Create enrichment

`POST /v1/enrichments`

## Request

- Base URL: `https://api.abm.dev`
- URL: `https://api.abm.dev/v1/enrichments`
- Auth: API key in header `X-API-Key`

Submit a new enrichment request. Returns 202 while processing completes asynchronously.

## Request body

- object
  - `type` 'person' | 'company', required: Entity type to enrich. For 'person' supply name/email/linkedInUrl; for 'company' supply companyName + domain or website (or linkedInCompanyPage).
  - `input` EnrichmentInput, required
    - `name` string
    - `email` string, email
    - `firstName` string
    - `lastName` string
    - `company` string
    - `companyName` string
    - `firmName` string
    - `linkedInUrl` string, uri
    - `linkedInCompanyPage` string, uri
    - `domain` string
    - `website` string, uri
    - `crmId` string

## Response `202`

Enrichment accepted for processing

- EnrichmentSummary
  - `id` integer
  - `status` 'queued' | 'processing' | 'completed' | 'approved' | 'writeback_pending' | 'synced' | 'failed' | 'cancelled' | 'partial_success'
  - `type` string
  - `created_at` string, date-time

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/abm/apis/abm-dev-api.md) · [All operations](https://skmtc.dev/abm/apis/abm-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/abm/apis/abm-dev-api/revisions/970c68654961?raw)
