# Bettercontact

Smart Waterfall Email & Phone Finder for contact enrichment and lead generation

- **Category:** contact management
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `BETTERCONTACT`
- **Version:** 00000000_00

## Tools

### Check Credits Balance

**Slug:** `BETTERCONTACT_CHECK_CREDITS_BALANCE`

Tool to check the remaining credits balance for a BetterContact account. Use when you need to verify available credits before making API requests that consume credits.

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

### Create Lead Finder Search

**Slug:** `BETTERCONTACT_CREATE_LEAD_FINDER_SEARCH`

Tool to create a new Lead Finder search to discover leads based on company and people criteria. Use when you need to find prospects matching specific job titles, departments, seniority, company size, industry, or technology stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | Yes | Filters to apply when searching for leads. At least one filter must be specified |
| `webhook` | string | No | Optional webhook URL to receive results automatically when the search completes |
| `max_leads` | integer | No | Maximum number of leads to return in the search results |

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

### Enrich Leads

**Slug:** `BETTERCONTACT_ENRICH_LEADS`

Tool to create a lead enrichment request for work emails and direct phone numbers. Uses waterfall enrichment across multiple data providers for higher accuracy. Supports batches of 1-100 leads.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | Yes | Array of leads to enrich. Minimum: 1 lead. Maximum: 100 leads per request. |
| `webhook` | string | No | Webhook URL where enrichment results will be pushed once processing is complete. |
| `process_flow` | string | No | Process flow ID to use for enrichment, if subscribed to the process flow add-on. |
| `enrich_phone_number` | boolean | Yes | If true, direct phone number of the contact will be enriched using waterfall enrichment. |
| `enrich_email_address` | boolean | Yes | If true, work email address of the contact will be enriched using waterfall enrichment. |

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

### Get Enrichment Results

**Slug:** `BETTERCONTACT_GET_ENRICHMENT_RESULTS`

Tool to retrieve enrichment results for a specific request ID. Use when you need to check the status and get enriched lead data including email addresses, contact information, and summary statistics for a submitted enrichment request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | The unique identifier for the enrichment request. This ID is returned when you submit an enrichment request. |

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

### Get Lead Finder Results

**Slug:** `BETTERCONTACT_GET_LEAD_FINDER_RESULTS`

Tool to retrieve results from a submitted Lead Finder search. Returns comprehensive lead and company data including contact information, LinkedIn profiles, job titles, company details, and enrichment data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | The unique identifier of the Lead Finder search request to retrieve results for |

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