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

# Leads

Leads are the most important object in Close. They represent a company or organization and can contain contacts, tasks, opportunities, and activities. In fact, these other objects _must_ be children of a Lead. You can think of a Lead in Close like both a "lead" and "account" in the terminology of some other CRMs.

When a lead is returned, its basic info as well as related tasks, opportunities, and custom fields are included. Activities are excluded and must be fetched separately via the [Activities](/api/resources/activities) endpoint.

Custom fields that have a value are returned as `custom.FIELD_ID`, where FIELD_ID is the ID of the custom field (see [Custom Fields](/api/resources/custom-fields) for more details). Note that using the `custom` field dict is deprecated, and the field will be removed from the API.

When using the `_fields` parameter, specify `custom` to show all custom fields. Alternatively, only return a subset of custom fields by specifying a comma-separated list of one or more `custom.FIELD_ID` identifiers.

Smart Fields are not included in the response by default. To include them:

- Fetch a specific Smart Field with `?_fields=smart_field_name,other_lead_field_names`
- Fetch all Lead fields and all Smart Fields with `?_fields=_all`

Smart fields are calculated fields, like number of emails on a lead. To speed up your integration, we recommend that you only use the `_all` flag to discover what Smart Fields are available and then use `?_fields=specific,set,of,fields` to return only the fields you need.

To easily find Leads that match specific conditions, use the [Advanced Filtering API](/api/resources/advanced-filtering).

> Leads are the most important object in Close.


## API Docs

- Leads [List Leads](https://developer.close.com/api/resources/leads/list.md)
- Leads [Create a new lead](https://developer.close.com/api/resources/leads/create.md)
- Leads [Merge two leads](https://developer.close.com/api/resources/leads/merge.md)
- Leads [Get a single Lead](https://developer.close.com/api/resources/leads/get.md)
- Leads [Update an existing lead](https://developer.close.com/api/resources/leads/update.md)
- Leads [Delete a lead](https://developer.close.com/api/resources/leads/delete.md)
- Leads [List files attached to a lead](https://developer.close.com/api/resources/leads/files-list.md)
- Leads [Attach a file to a lead](https://developer.close.com/api/resources/leads/files-create.md)

## OpenAPI Specification

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