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

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# 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