---
title: "Listclean integration for LuumenAI"
url: "https://www.luumen.ai/integrations/listclean/"
entity: SoftwareIntegration
category: "Communication"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Listclean integration for LuumenAI

Verify email lists, check credits, and run batch cleanups from the terminal

## What LuumenAI can do with Listclean

LuumenAI connects to Listclean with an API token and exposes 16 tools (11 read-only · 4 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 16 tools (11 read-only · 4 write · 1 destructive)
- Plan: available on all plans
- Category: Communication

## About Listclean with LuumenAI

Connect Listclean and your agent can check an address, pull the results of a past verification run, and see how many credits are left before it spends any. Bulk work stays in the same place: start a CSV upload, verify a batch, and read back the status without leaving the terminal. Verification and cleanup steps are previewed before they run.

## Example tools

Read-only (11 in total):

- `LISTCLEAN_CREATE_BULK_VERIFICATION_LIST` — Create a CSV file with provided email addresses for bulk verification.
- `LISTCLEAN_DOWNLOAD_CSV` — Download list results as a CSV file.
- `LISTCLEAN_DOWNLOAD_JSON` — Download list results as JSON.
- `LISTCLEAN_GET_ACCOUNT_PROFILE` — Retrieve the authenticated account's profile.
- `LISTCLEAN_GET_CREDITS` — Retrieve remaining verification credits.
- `LISTCLEAN_GET_LIST` — Retrieve detailed information for a specific list.
- `LISTCLEAN_GET_UPLOAD_STATUS` — Retrieve the status of a specific upload.
- `LISTCLEAN_GET_VERIFICATION_LOGS` — Retrieve logs for all single email verifications.

Write and destructive (5 in total, approval required by default):

- `LISTCLEAN_DELETE_LIST` — Permanently delete a single list from the account.
- `LISTCLEAN_START_UPLOAD` — Start a CSV upload process for bulk email verification.
- `LISTCLEAN_UPDATE_PROFILE` — Update account profile details.
- `LISTCLEAN_UPLOAD_CHUNK` — Upload a chunk of a CSV file.
- `LISTCLEAN_VERIFY_BATCH` — Verify a batch of email addresses (max 3000 emails).

## Frequently asked questions

### How does LuumenAI connect to Listclean?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Listclean on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Listclean — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/listclean/