> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Helloleads

> HelloLeads is a smart and simple lead management solution designed for small businesses to streamline lead capture, tracking, and engagement.

![Helloleads logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/helloleads.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=096472c032917917d70da37352ca5383)

* **Category:** crm
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `HELLOLEADS`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Lead
>
> **Slug:** `HELLOLEADS_CREATE_LEAD`
>
> Add a new lead to a HelloLeads list. Requires a first name, list key, and either an email address or mobile number.
>
> #### Input Parameters
>
> **fax** `string`
>
> Fax number (max 30 characters).
>
> **city** `string`
>
> City (max 30 characters).
>
> **tags** `string`
>
> Comma-separated tags (max 450 chars; avoid special characters).
>
> **email** `string`
>
> Primary email of the lead (max 100 chars). Either email or mobile is required.
>
> **notes** `string`
>
> Additional notes (max 2000 characters).
>
> **phone** `string`
>
> Work phone number (max 30 characters).
>
> **state** `string`
>
> State or province (max 30 characters).
>
> **mobile** `string`
>
> Mobile phone number (max 30 chars). Either email or mobile is required.
>
> **company** `string`
>
> Company name (max 100 characters).
>
> **country** `string`
>
> Country (max 30 characters).
>
> **website** `string`
>
> Website URL (max 200 characters).
>
> **category** `string`
>
> Customer group/category (max 450 chars; avoid special characters).
>
> **list\_key** `string` *required*
>
> Target list key where the lead will be added.
>
> **deal\_size** `string`
>
> Deal size or value (max 15 characters).
>
> **interests** `string`
>
> Comma-separated interests (max 450 chars; avoid special characters).
>
> **last\_name** `string`
>
> Last name of the lead (max 80 characters).
>
> **potential** `string ("High" | "Medium" | "Low" | "Not Relevant")`
>
> Lead potential rating.
>
> **first\_name** `string` *required*
>
> First name of the lead (max 50 characters).
>
> **designation** `string`
>
> Lead's designation or job title (max 50 characters).
>
> **mobile\_code** `string`
>
> Mobile country code (max 50 characters).
>
> **postal\_code** `string`
>
> Postal or ZIP code (max 30 characters).
>
> **address\_line1** `string`
>
> Address line 1 (max 250 characters).
>
> **address\_line2** `string`
>
> Address line 2 (max 250 characters).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Leads
>
> **Slug:** `HELLOLEADS_LIST_LEADS`
>
> Tool to list all leads from HelloLeads. Use after authentication to fetch the entire lead list. Returns empty list if none found.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Lead Lists
>
> **Slug:** `HELLOLEADS_LIST_LISTS`
>
> Tool to retrieve all lead list keys from HelloLeads. Use when you need to enumerate available lists for lead insertion.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
