# Listclean AI integration on Definable

> Listclean is an email verification service that helps users validate and clean their email lists to improve deliverability and maintain sender reputation.

## What this connects

Listclean is an email verification service that helps users validate and clean their email lists to improve deliverability and maintain sender reputation.

Vendor: https://listclean.xyz/

## Tools available

**16** tools available. First 12:

- `LISTCLEAN_CREATE_BULK_VERIFICATION_LIST` — Create Bulk Verification List — Tool to create a CSV file with provided email addresses for bulk verification. Use when you need to generate a file for bulk upload through LISTCLEAN_UPLOAD_LIST.
- `LISTCLEAN_DELETE_LIST` — Delete List — Tool to permanently delete a single list from the account. Use when you need to remove a list that is no longer needed.
- `LISTCLEAN_DOWNLOAD_CSV` — Download List Results as CSV — Tool to download list results as a CSV file. Use when you need to retrieve verification results filtered by email type (clean, dirty, or unknown).
- `LISTCLEAN_DOWNLOAD_JSON` — Download List Results as JSON — Tool to download list results as JSON. Downloads emails filtered by type (clean, dirty, or unknown) in JSON format. Use after list verification is complete to retrieve filtered results.
- `LISTCLEAN_GET_ACCOUNT_PROFILE` — Get Account Profile — Tool to retrieve the authenticated account's profile. Use after obtaining a valid auth token to fetch user account data.
- `LISTCLEAN_GET_CREDITS` — Get Remaining Credits — Tool to retrieve remaining verification credits. Use when you need to check your available account credits before performing more email verifications.
- `LISTCLEAN_GET_LIST` — Get List Information — Tool to retrieve detailed information for a specific list. Returns analytics with clean/dirty breakdown, cost details, and processing status.
- `LISTCLEAN_GET_UPLOAD_STATUS` — Get Upload Status — Tool to retrieve the status of a specific upload. Returns upload status (inprocess, success, error), progress percentage, and chunk details. Use after initiating an upload to track its completion.
- `LISTCLEAN_GET_VERIFICATION_LOGS` — Get Verification Logs — Tool to retrieve logs for all single email verifications. Returns history of email verifications with status, remarks, credits deducted, and timestamps.
- `LISTCLEAN_LIST_ALL` — List All Verification Lists — Tool to retrieve all email verification lists. Returns all processed lists with complete analytics including clean/dirty counts, summary statistics, and cost information.
- `LISTCLEAN_LIST_UPLOADS` — List CSV Uploads — Tool to retrieve the list of CSV uploads. Use when you need to check upload IDs, status, and progress for all CSV file uploads in your account.
- `LISTCLEAN_START_UPLOAD` — Start Upload — Tool to start a CSV upload process for bulk email verification. Initializes chunked file upload and returns an upload_id for subsequent chunk uploads. Use when you need to upload large CSV files containing email addresses.

## Auth

Auth schemes: `API_KEY`.

## How agents use Listclean

Inside a Definable workflow, Listclean is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Listclean** — the Researcher (GPT-5.5) pulls context from Listclean (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Listclean** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Listclean (create record, post message, draft email).
- **Designer / Engineer → Distributor → Listclean** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Listclean (attach file, open PR comment, post status).

The Verifier checks every Listclean call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- email — https://definable.ai/apps/category/email/
- marketing automation — https://definable.ai/apps/category/marketing-automation/

## Related

- HTML page: https://definable.ai/apps/listclean/
- Same category (email): https://definable.ai/apps/category/email/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt