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

# Bettercontact

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

![Bettercontact logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/bettercontact.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=887ca583231879e91bd8394a55742f4a)

* **Category:** contact management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 5
* **Triggers:** 0
* **Slug:** `BETTERCONTACT`
* **Version:** 20261101\_00

## Tools

> [accordion] 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
>
> **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] Create Lead Finder Search
>
> **Slug:** `BETTERCONTACT_CREATE_LEAD_FINDER_SEARCH`
>
> Create a Lead Finder search to discover leads based on company and people criteria, such as job titles, departments, seniority, company size, and industry.
>
> #### Input Parameters
>
> **filters** `object` *required*
>
> Filters to apply when searching for leads. At least one filter must be specified
>
> **webhook** `string`
>
> Optional webhook URL to receive results automatically when the search completes
>
> **max\_leads** `integer`
>
> Maximum number of leads to return in the search results
>
> #### 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] 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
>
> **data** `array` *required*
>
> Array of leads to enrich. Minimum: 1 lead. Maximum: 100 leads per request.
>
> **webhook** `string`
>
> Webhook URL where enrichment results will be pushed once processing is complete.
>
> **process\_flow** `string`
>
> Process flow ID to use for enrichment, if subscribed to the process flow add-on.
>
> **enrich\_phone\_number** `boolean` *required*
>
> If true, direct phone number of the contact will be enriched using waterfall enrichment.
>
> **enrich\_email\_address** `boolean` *required*
>
> If true, work email address of the contact will be enriched using waterfall enrichment.
>
> #### 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] Get Enrichment Results
>
> **Slug:** `BETTERCONTACT_GET_ENRICHMENT_RESULTS`
>
> Retrieve the status and available enrichment results for a submitted request ID, including email addresses, contact details, and summary statistics. Results and summary may be absent until the request is terminated.
>
> #### Input Parameters
>
> **request\_id** `string` *required*
>
> The unique identifier for the enrichment request. This ID is returned when you submit an enrichment request.
>
> #### 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] Get Lead Finder Results
>
> **Slug:** `BETTERCONTACT_GET_LEAD_FINDER_RESULTS`
>
> Retrieve the status and available results of a submitted Lead Finder search, including lead and company details and any available enrichment data. Results may be absent until the search is terminated.
>
> #### Input Parameters
>
> **request\_id** `string` *required*
>
> The unique identifier of the Lead Finder search request to retrieve results for
>
> #### 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
