> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BetterContact

> Connect BetterContact for waterfall enrichment to find emails and phones in your workflows.

## How to set up BetterContact

### Authentication

BetterContact uses API key authentication:

1. Sign up at [bettercontact.rocks](https://bettercontact.rocks)
2. Navigate to your API settings
3. Copy your API key
4. Paste the API key in Cargo when connecting

## BetterContact actions

### Find email

Find a person's email address using multiple data sources (waterfall enrichment).

**Input fields (provide as many as available):**

* **First name**: Person's first name
* **Last name**: Person's last name
* **Company**: Company name
* **Company domain**: Company domain
* **LinkedIn URL**: Person's LinkedIn profile URL

**Use case:** Waterfall enrichment checks multiple providers to maximize match rates.

### Find phone

Find a person's phone number using multiple data sources.

**Input fields (provide as many as available):**

* **First name**: Person's first name
* **Last name**: Person's last name
* **Company**: Company name
* **Company domain**: Company domain
* **LinkedIn URL**: Person's LinkedIn profile URL

**Use case:** Maximize phone number discovery through waterfall approach.

## How waterfall enrichment works

BetterContact automatically queries multiple data providers in sequence until a match is found. This approach:

* **Maximizes coverage**: If one provider fails, others are tried
* **Improves accuracy**: Results are cross-validated
* **Simplifies workflows**: One integration instead of many

## Retry behavior

BetterContact actions include extensive retry logic:

* Maximum 20 retry attempts
* 60-second intervals between retries
* Handles provider rate limits automatically

This ensures reliable results even when individual providers are slow.

## Rate limits

BetterContact API has a rate limit of 60 requests per minute. Cargo handles rate limiting automatically.

## Best practices

* Provide as many input fields as possible for best results
* LinkedIn URL often provides the best matching
* Include company domain for higher accuracy
* Use waterfall as a fallback for other enrichment sources
* Cache results to avoid redundant lookups