Skip to main content
TrueList logo
  • Category: email
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: TRUE_LIST
  • Version: 20261030_00

Tools

Slug: TRUE_LIST_CREATE_BATCHCreate an asynchronous TrueList batch email-validation job from tabular rows. A successful call consumes validation credits, so use ESTIMATE_BATCH first when cost or row counts are uncertain.

Input Parameters

array
required
Tabular rows for the batch, with a header row first and at least one data row containing an email value. A successful request consumes validation credits.
string
Name shown for the uploaded data and batch.
string
HTTPS callback URL that TrueList should POST the batch ID to when processing completes.
string ("accurate" | "fast")
Batch validation strategy. fast skips retries; accurate performs the standard validation flow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_DELETE_BATCHPermanently delete one completed TrueList batch and its validation results. This destructive operation cannot be undone, and TrueList rejects deletion when the batch is missing or has not completed.

Input Parameters

string
required
UUID of the completed batch to permanently delete. This removes the batch and its validation results and cannot be undone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_ESTIMATE_BATCHEstimate email count, duplicates, and processing time for tabular batch data without creating a batch or consuming batch-validation credits.

Input Parameters

array
required
Tabular rows to estimate, with a header row first and one email value in each data row.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_GET_ACCOUNTReturn the connected TrueList user identity, account name, and payment plan without exposing API tokens or other account users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_GET_BATCHGet one TrueList batch-validation job by UUID, including progress counts and completed result download URLs. The provider may return nonterminal states including pending, pending_processing, processing, and finalizing.

Input Parameters

string
required
UUID of the batch to retrieve, returned by create or list batches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_LIST_BATCHESList all batch-validation jobs in the connected TrueList account, including their current processing state, progress counts, and available result download URLs. TrueList returns the complete list without documented pagination.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_LIST_VALIDATION_HISTORYReturn one page of previously validated email results, optionally filtered by batch, address, state, or sub-state.

Input Parameters

string
Return history for this exact address as TrueList recorded it, including addresses it marked failed_syntax_check.
string
Return only validation results belonging to this batch UUID.
integer
Maximum results to return in this page (1-100).
string ("ok" | "risky" | "invalid" | "unknown")
Filter by TrueList’s history-filter state. Returned result states may use provider variants such as email_invalid.
string
Continuation cursor returned by the previous call; omit for the first page.
string ("email_ok" | "accept_all" | "is_disposable" | "is_role" | "failed_mx_check" | "failed_smtp_check" | "failed_no_mailbox" | "failed_greylisted" | "failed_syntax_check")
Filter by the specific validation outcome reason.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRUE_LIST_VALIDATE_EMAILValidate one email address synchronously, consume validation capacity, and add the result to TrueList validation history.

Input Parameters

string
required
Single email address to validate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not