# Helloleads

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

- **Category:** crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `HELLOLEADS`
- **Version:** 20260211_00

## Tools

### Create Lead

**Slug:** `HELLOLEADS_CREATE_LEAD`

Tool to add a new lead into HelloLeads. Use when you need to push a fresh lead record with mandatory first name and list key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fax` | string | No | Fax number (max 30 characters). |
| `city` | string | No | City (max 30 characters). |
| `tags` | string | No | Comma-separated tags (max 450 chars; avoid special characters). |
| `email` | string | No | Primary email of the lead (max 100 chars). Either email or mobile is required. |
| `notes` | string | No | Additional notes (max 2000 characters). |
| `phone` | string | No | Work phone number (max 30 characters). |
| `state` | string | No | State or province (max 30 characters). |
| `mobile` | string | No | Mobile phone number (max 30 chars). Either email or mobile is required. |
| `company` | string | No | Company name (max 100 characters). |
| `country` | string | No | Country (max 30 characters). |
| `website` | string | No | Website URL (max 200 characters). |
| `category` | string | No | Customer group/category (max 450 chars; avoid special characters). |
| `list_key` | string | Yes | Target list key where the lead will be added. |
| `deal_size` | string | No | Deal size or value (max 15 characters). |
| `interests` | string | No | Comma-separated interests (max 450 chars; avoid special characters). |
| `last_name` | string | No | Last name of the lead (max 80 characters). |
| `potential` | string ("High" | "Medium" | "Low" | "Not Relevant") | No | Lead potential rating. |
| `first_name` | string | Yes | First name of the lead (max 50 characters). |
| `designation` | string | No | Lead's designation or job title (max 50 characters). |
| `mobile_code` | string | No | Mobile country code (max 50 characters). |
| `postal_code` | string | No | Postal or ZIP code (max 30 characters). |
| `address_line1` | string | No | Address line 1 (max 250 characters). |
| `address_line2` | string | No | Address line 2 (max 250 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |