> For a complete page index, fetch https://developer.close.com/llms.txt

# Field Enrichment

Field Enrichment uses AI to intelligently populate fields on leads and contacts.

The Field Enrichment API waits for the enrichment process to complete
before returning a response. Fields with complex guidance or requirements
may time out / not complete. If this happens consistently, try to simplify
the instructions or reduce the scope of the request.

## Supported Field Types

The Field Enrichment API works with various custom field types:
- **Text Fields**: Company descriptions, job titles, notes
- **Choice Fields**: Industry categories, lead sources, priorities
- **Number Fields**: Employee counts, revenue estimates, scores
- **Date Fields**: Founded dates, last contact dates
- **Multi-Choice Fields**: Tags, categories, services offered

For best results, configure guidance for each field within the field
settings in the Close app.

### Update Strategy

By default, values are saved but only if the field does not already
have a value. Saving values may be disabled by specifying
`set_new_value: false` in the request, or enrichment can be set to
overwrite any existing values by specifying
`overwrite_existing_value: true`.

<Note>
- **Synchronous Operation**: This endpoint waits for enrichment to complete, which may take several seconds
- **Cost Considerations**: Each enrichment request may consume credits or incur costs
- **Rate Limiting**: Heavy usage may be subject to rate limiting
</Note>

> Field Enrichment uses AI to intelligently populate fields on leads and contacts


## API Docs

- AI Field Enrichment [Enrich a specific field on a lead or contact using AI](https://developer.close.com/api/resources/field-enrichment/create.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developer.close.com/api/resources/field-enrichment/openapi.json)
- [OpenAPI YAML](https://developer.close.com/api/resources/field-enrichment/openapi.yaml)