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

# Forms

Forms let you collect lead information from your website and pipe it straight into Close.
You [build a form in Close](https://app.close.com/settings/web-forms/), embed it on your site,
and each submission automatically creates (or updates) a Lead and Contact and records a
[Form Submission](/api/resources/activities/form-submissions) activity on the Lead's timeline.
See the [product help docs](https://help.close.com/docs/forms) for details on building, styling, and embedding forms.

Each form object represents a form your team has built in Close: its name, its archive status,
and the list of **field definitions** it contains. Each field definition (`formfld_xxx`) describes
one field on the form — its name, its type, and, for select fields, the available choices. Those
same `formfld_xxx` IDs appear as keys in the `values` map on each Form Submission activity, so
listing forms is how you turn those raw submission payloads into something human-readable.

Note that all forms endpoints are currently read-only.

> Capture leads from your website with embeddable forms that flow directly into Close.


## API Docs

- Forms [List Forms](https://developer.close.com/api/resources/forms/list.md)
- Forms [Retrieve a Form](https://developer.close.com/api/resources/forms/fetch.md)

## OpenAPI Specification

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