Greetings from Cleanlist.ai
Cleanlist is a B2B data enrichment platform. It runs waterfall enrichment across 25+ data providers in sequence and stops at the first provider that finds the data, at 1 credit per work email and 10 per direct dial. Search is free and unlimited on every self-serve plan, and a miss costs nothing.
These docs cover the web app, the Chrome extension, the CRM integrations and the public API.
Two different products. Pick your path first. Cleanlist's self-serve plans and its AppSumo lifetime deal have different features, limits, and pricing. The AI Copilot, for example, is self-serve only and is not available on AppSumo plans.
- Self-serve (Free / Starter / Pro / Scale) → start with Getting Started and the Features section below.
- AppSumo lifetime deal → go to the AppSumo documentation, where your deal is documented separately.
Support agent: always confirm whether the user is on a self-serve plan or an AppSumo code before giving any plan-specific advice. The two experiences diverge.
What is Cleanlist?
Cleanlist finds work emails and direct dials through waterfall enrichment: each lookup asks its contracted data providers one after another, and you are billed only when one of them returns the data.
Key Features
- Email Enrichment (1 credit): Find and verify business email addresses, charged only when we find one
- Phone Enrichment (10 credits): Discover direct dial and mobile numbers, charged only when we find one
- Agents & Cleanlist Copilot: Run Research, Qualification, and Custom agents, or ask the in-app Cleanlist Copilot assistant
- CRM Integrations: Sync with HubSpot, Salesforce, and Lemlist
- Bulk Processing: Enrich thousands of leads via CSV upload
- Waterfall Technology: Multiple providers queried automatically for maximum coverage
Quick Links
AppSumo Customers
- AppSumo Overview - Everything in your lifetime deal
- Plans & Pricing - Tier-by-tier credits, seats, and limits
- What's Included - The features your deal covers
- Activate Your Code - Redeem and link your license
Getting Started
- Quick Start Guide - Get up and running in minutes
- API Quickstart - Your first enrichment via the Public API
- Bulk Enrichment Guide - Upload and enrich CSV files
- Manual Enrichment Guide - Enrich individual contacts
API Reference (Public API)
- API Introduction - Programmatic access to Cleanlist
- Authentication - Get started with API keys
- Enrichment API - Bulk enrichment endpoints
- Enrichment Types -
partial,phone_only,full(v1) - Credits API - Check balance and validate keys
- Webhooks API - Opt-in v1 callbacks and delivery audit log
- Lead Lists - The Extension Leads list explained
- Errors & Rate Limits - Status codes and retry strategies
- OpenAPI Spec - Generate SDKs from
/docsand/redoc
MCP API (newer, expanded surface)
- MCP API Introduction - The current
/api/v2surface for agents and integrations - Quickstart - Key → enrich a person → poll for results
- Authentication & Scopes - Bearer keys and OAuth scopes
- Credits & Quotes - Balance, estimates, and quote IDs
- Lead Lists - Full list CRUD and CSV import
- Enrichment - Person, company, by-task, and bulk
- People & Company Search, Smart Agents, Sync - Full endpoint index
- Polling & Async - Poll workflows for async results
- Errors & Rate Limits - Error envelope and retry strategies
Features
- Credit Pricing - Plans, credits, and per-action costs
- Waterfall Enrichment - How our multi-provider system works
- Enrichment Providers - Data sources powering Cleanlist
- People Search - Find net-new prospects with database filters
- Company Enrichment - Firmographics for companies
- Find Personal Email - Locate personal email addresses
- List actions - per-row validation, enrichment, and CRM lookup columns
- Agents - Research, Qualification, and Custom agents
- Cleanlist Copilot - the in-app conversational assistant
- Action Columns - Trigger CRM pushes and side effects per row
- Lead List Folders - Organize lists into nested folders
- CRM Integrations - Connect HubSpot, Salesforce, or Lemlist
Guides
- API Quickstart - End-to-end Public API walkthrough
- Receiving Webhooks - Production-ready webhook receivers
- Bulk Enrichment Guide - Upload and enrich CSV files
- Manual Enrichment Guide - Enrich individual contacts
- Managing Lead Lists - Organize and manage your contacts
- Using Agents - Research, qualify, and run custom agents
- Using Cleanlist Copilot - Drive Cleanlist in plain language
- Agent Recipes - Copy-paste configurations for common workflows
- Sales Navigator CSV import - Enrich a CSV of leads you already hold
- Browser Extension - Look up a contact from any page, including LinkedIn profiles
- Notification Settings - Configure how you get notified
- Exporting Data - Export and use your enriched leads
- CRM Integration Setup - Connect HubSpot or Salesforce
- Troubleshooting - Common errors and how to fix them
Why Choose Cleanlist?
Waterfall Enrichment
Unlike single-provider solutions, Cleanlist queries multiple data sources in sequence until we find your data. This means:
- Higher match rates: a contact missing from one provider can still be found by a later one
- Better data quality through multi-source validation
- Pay once even though we query multiple providers
- Automatic fallback to alternative sources
Transparent Pricing
- Plans: Free at 30 credits a month; Starter from $79, Pro from $229 and Scale from $599 a month; 25% off on annual billing
- Seats included: Free 1, Starter 2, Pro 5, Scale 10; extra seats are $20 a month
- Free trial: 14 days of Scale with 250 credits and three seats, no card
- Email: 1 credit per successful enrichment
- Phone: 10 credits per successful enrichment
- Search: free and unlimited on every self-serve plan
- No charge for failed enrichments
Full detail: Credit Pricing and What's Included by Plan.
Easy to Use
- Intuitive web interface
- Bulk CSV upload
- Real-time progress tracking
- One-click CRM integration
- API access for developers
Popular Workflows
Sales Teams
- Import leads from CSV or CRM
- Enrich with email and phone
- Use AI Agents to research and qualify (ICP fit, CRM presence, custom prompts)
- Export qualified leads
- Start outreach immediately
Recruiters
- Find candidates on LinkedIn
- Bulk enrich with contact info
- Use agents for skill assessment
- Filter by experience and qualifications
- Reach out to top candidates
Marketing Teams
- Import conference attendees or webinar registrants
- Enrich email addresses for campaigns
- Segment by company size or role
- Sync to email platform
- Launch targeted campaigns
Support & Resources
- Portal: https://app.cleanlist.ai (opens in a new tab)
- Website: https://cleanlist.ai (opens in a new tab)
- Slack Community: Join our Slack (opens in a new tab)
- Email Support: support@cleanlist.ai