---
title: "Create an Enrichment"
method: POST
path: "/v0/websets/{webset}/enrichments"
tags: ["Enrichments"]
---

# Create an Enrichment

`POST /v0/websets/{webset}/enrichments`

Create an Enrichment for a Webset.

## Path parameters

- `webset` string, required

## Request body

- CreateEnrichmentParameters
  - `description` string, required — Provide a description of the enrichment task you want to perform to each Webset Item.
  - `format` 'text' | 'date' | 'number' | 'options' | 'email' | 'phone' | 'url'
  - `options` object[] — When the format is options, the different options for the enrichment agent to choose from.
    - `label` string, required — The label of the option
  - `metadata` object — Set of key-value pairs you want to associate with this object.

## Response `200`

Enrichment created

- WebsetEnrichment
  - `id` string, required — The unique identifier for the enrichment
  - `object` 'webset_enrichment', required — The type of object
  - `status` 'pending' | 'canceled' | 'completed', required — The status of the enrichment
  - `websetId` string, required — The unique identifier for the Webset this enrichment belongs to.
  - `title` string, nullable, required — The title of the enrichment. This will be automatically generated based on the description and format.
  - `description` string, required — The description of the enrichment task provided during the creation of the enrichment.
  - `format` 'text' | 'date' | 'number' | 'options' | 'email' | 'phone' | 'url', required
  - `options` object[], nullable, required — When the format is options, the different options for the enrichment agent to choose from.
    - `label` string, required — The label of the option
  - `instructions` string, nullable, required — The instructions for the enrichment Agent. This will be automatically generated based on the description and format.
  - `metadata` object — The metadata of the enrichment
  - `createdAt` string, date-time, required — The date and time the enrichment was created
  - `updatedAt` string, date-time, required — The date and time the enrichment was updated

## Changes

- **2026-09-23** `a56858d08d37` — 1 warning
  - the `metadata/propertyNames/` request property's maxLength was set to `250`
- **2026-09-13** `068993f25c35` — 1 breaking, 1 info
  - added 'propertyNames' constraint to the request property `metadata`
  - added 'propertyNames' constraint to the `metadata` response property for the status `200`

[Change history](https://skmtc.dev/exa/apis/exa-public-api/changes/v0/websets/:webset/enrichments/post.md)

---

[API](https://skmtc.dev/exa/apis/exa-public-api.md) · [All operations](https://skmtc.dev/exa/apis/exa-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/exa/apis/exa-public-api/revisions/9006c0dd9616?raw)