Truelist icon

Truelist

Validate email addresses with Truelist

Actions8

Batch → Create

AI-generated

Summary

Create a new batch of email addresses to validate by submitting a list of emails along with optional parameters like batch filename, validation strategy, and webhook callback URL.

Inputs

  • Emails (required) — Provide a comma-separated list of email addresses or a JSON array of email strings to be validated in bulk.
  • Additional Fields — Optional settings for the batch including 'Filename' to name the batch file, 'Validation Strategy' to choose the thoroughness of validation, and 'Webhook URL' to receive notifications when the batch completes.

Output shape

a single JSON object representing the created batch, including batch metadata and status information

The batch creation response contains details about the batch. The batch process runs asynchronously and can notify completion via the provided webhook URL if specified.

Examples

Example 1: Creating batch with comma-separated emails and default validation

Set 'Emails' to a comma-separated list like 'user1@example.com, user2@example.com' and leave 'Additional Fields' empty or default.

Example 2: Creating batch with enhanced validation and webhook

Set 'Emails' as above, set 'Validation Strategy' to 'Enhanced', set 'Webhook URL' to your callback endpoint to receive batch completion notification, optionally specify 'Filename'.

Links

Discussion