---
title: "Submit enrichment"
method: POST
path: "/api/enrichments"
tags: ["Enrichments"]
---

# Submit enrichment

`POST /api/enrichments`

Enrich one contact or a batch of contacts with requested fields such as verified email, phone, and signals. Small contact-only requests can complete immediately; larger requests return an operation to poll.

## Headers

- `Idempotency-Key` string

## Request body

- PostEnrichmentDto
  - `identifier` PersonIdentifierRecordDto
    - `linkedin_url` string
    - `email` string
    - `x_handle` string
    - `github_username` string
  - `identifiers` PersonIdentifierRecordDto[] — Batch (max 100); mutually exclusive with identifier
    - `linkedin_url` string
    - `email` string
    - `x_handle` string
    - `github_username` string
  - `fields` string[], required
  - `signals_config` SignalsConfigDto
    - `platforms` string[] — Opt-in platforms; omit or empty = all
    - `max_posts` object
    - `intent_signals` string[]
    - `since_days` number
    - `handles` object

## Response `200`

Enrichment completed immediately.

- EnrichmentSyncResponseDto
  - `data` object, required
  - `meta` PublicResponseMetaDto, required
    - `requestId` string, required

## Other responses

- `202` — Enrichment accepted. Poll the returned URL for status and results.
- `400` — The request body or parameters are invalid.
- `401` — Authentication is required.
- `402` — The organization does not have enough credits for this request.
- `500` — An unexpected error occurred.

---

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