Listclean

email 16 tools available

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

Connect Listclean Visit Listclean

About this integration

Connect Listclean to Definable to triage inboxes, draft and queue follow-ups, classify and route incoming threads. Personas call Listclean's 16 tools directly from chat or scheduled flows. Hand off to an email persona to triage, draft, and route — with you in the loop on every outbound.

Connect Listclean to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 16 exposed

Plans All, incl. Free

Data Never trained on

Listclean · in workflows

What teams actually run.

Three patterns teams run with Listclean on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Inbox triage

│ Read incoming threads

│ Classify by intent + urgency

└ Draft replies for review

Auto-follow-up

│ Detect emails awaiting reply for 3+ days

│ Draft contextual nudges

└ Queue for one-click send

Lead capture

│ Listen for inbound from a form alias

│ Extract details

└ Push to the CRM

16 tools available

The Listclean toolbox.

Every Listclean capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

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.

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.

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

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.

Get Account Profile

Tool to retrieve the authenticated account's profile. Use after obtaining a valid auth token to fetch user account data.

Get Remaining Credits

Tool to retrieve remaining verification credits. Use when you need to check your available account credits before performing more email verifications.

Get List Information

Tool to retrieve detailed information for a specific list. Returns analytics with clean/dirty breakdown, cost details, and processing 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.

Get Verification Logs

Tool to retrieve logs for all single email verifications. Returns history of email verifications with status, remarks, credits deducted, and timestamps.

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.

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.

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.

Update Account Profile

Tool to update account profile details. Use when you need to modify user profile information such as name, address, contact details, company information, or billing details.

Upload Chunk

Tool to upload a chunk of a CSV file. Use when sending base64-encoded content with sequence number as part of chunked upload process, optionally with MD5 checksum for integrity verification.

Verify Batch of Emails

Tool to verify a batch of email addresses (max 3000 emails). Use when you need to verify multiple emails at once and get a list_id for tracking the batch verification request.

Verify Email Address

Tool to verify an email's validity. Use when you need to ensure an address is deliverable and non-disposable, after collecting a user's email.

See it run

One prompt, start to finish.

A real prompt, the Listclean tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Listclean task end-to-end — plan it, execute across the API, and hand back a verified result.

listclean.create_bulk_verification_list Tool to create a CSV file with provided email addresses for bulk verification. Use when yo

listclean.delete_list Tool to permanently delete a single list from the account. Use when you need to remove a l

listclean.download_list_results_as_csv Tool to download list results as a CSV file. Use when you need to retrieve verification re · verified

done

Done. Listclean responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Listclean

Questions, answered.

What teams ask before connecting Listclean.

01 What can I automate with Listclean on Definable?

Anything Listclean exposes through its API. Common email workflows on Definable include triage inboxes, draft and queue follow-ups, classify and route incoming threads. Personas can call any of the 16 Listclean tools directly, then chain the result into another integration without you writing code.

02 How does Listclean authentication work?

Listclean uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

03 Is the Listclean integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 16 Listclean tools. You only need a separate Listclean subscription if Listclean itself charges per seat or per API call.

04 Is using Listclean through Definable secure?

Every call from a persona to Listclean is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

05 How do I get started with Listclean on Definable?

Sign up for Definable, open the integrations page, find Listclean, and connect via OAuth or API key. You can immediately attach Listclean to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

06 What Listclean actions does Definable expose?

Definable exposes all 16 Listclean actions as callable tools — including `Create Bulk Verification List`, `Delete List`, `Download List Results as CSV`, plus 13 more. Each tool gets a typed parameter schema so personas know exactly how to call it.