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

# TrueList integration for LuumenAI

Check email lists, run batch validation jobs, and read past results

## What LuumenAI can do with TrueList

LuumenAI connects to TrueList with an API token and exposes 8 tools (5 read-only · 2 write · 1 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 8 tools (5 read-only · 2 write · 1 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Communication

## About TrueList with LuumenAI

Connect TrueList and your agent can see the state of every batch validation job, the progress counts behind it, and the results of addresses you have already checked. Estimate a file before you spend credits on it. Start a batch or validate a single address as an approved step, with the plan shown first. Luumen authenticates with an API key.

## Example tools

Read-only (5 in total):

- `TRUE_LIST_ESTIMATE_BATCH` — Estimate email count, duplicates, and processing time for tabular batch data without creating a batch or consuming batch-validation credits.
- `TRUE_LIST_GET_ACCOUNT` — Return the connected TrueList user identity, account name, and payment plan without exposing API tokens or other account users.
- `TRUE_LIST_GET_BATCH` — Get one TrueList batch-validation job by UUID, including progress counts and completed result download URLs.
- `TRUE_LIST_LIST_BATCHES` — List all batch-validation jobs in the connected TrueList account, including their current processing state, progress counts, and available result download URLs.
- `TRUE_LIST_LIST_VALIDATION_HISTORY` — Return one page of previously validated email results, optionally filtered by batch, address, state, or sub-state.

Write and destructive (3 in total, subject to configured approval policy):

- `TRUE_LIST_CREATE_BATCH` — Create an asynchronous TrueList batch email-validation job from tabular rows.
- `TRUE_LIST_DELETE_BATCH` — Permanently delete one completed TrueList batch and its validation results.
- `TRUE_LIST_VALIDATE_EMAIL` — Validate one email address synchronously, consume validation capacity, and add the result to TrueList validation history.

## Frequently asked questions

### How does LuumenAI connect to TrueList?

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 TrueList on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

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

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