Skip to main content

How to set up BetterContact

Authentication

BetterContact uses API key authentication:
  1. Sign up at 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