> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.heyreach.io/hey-reach-api/lists/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.heyreach.io/_mcp/server.

# Overview

Methods for working with HeyReach lists. Get leads and companies from lists. And add leads to a list.


## API Docs

- Lists [GetById](https://docs.heyreach.io/hey-reach-api/lists/get-by-id.md)
- Lists [GetAll](https://docs.heyreach.io/hey-reach-api/lists/get-all.md)
- Lists [GetLeadsFromList](https://docs.heyreach.io/hey-reach-api/lists/get-leads-from-list.md)
- Lists [DeleteLeadsFromList](https://docs.heyreach.io/hey-reach-api/lists/delete-leads-from-list.md)
- Lists [DeleteLeadsFromListByProfileUrl](https://docs.heyreach.io/hey-reach-api/lists/delete-leads-from-list-by-profile-url.md)
- Lists [GetCompaniesFromList](https://docs.heyreach.io/hey-reach-api/lists/get-companies-from-list.md)
- Lists [AddLeadsToList](https://docs.heyreach.io/hey-reach-api/lists/add-leads-to-list.md)
- Lists [AddLeadsToListV2](https://docs.heyreach.io/hey-reach-api/lists/add-leads-to-list-v-2.md)
- Lists [GetListsForLead](https://docs.heyreach.io/hey-reach-api/lists/get-lists-for-lead.md)
- Lists [CreateEmptyList](https://docs.heyreach.io/hey-reach-api/lists/create-empty-list.md)
- Lists [UpdateLeadCustomFields](https://docs.heyreach.io/hey-reach-api/lists/update-lead-custom-fields.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.heyreach.io/openapi.json)
- [OpenAPI YAML](https://docs.heyreach.io/openapi.yaml)