Skip to main content
ZeroBounce logo
  • Category: people & contact data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 22
  • Triggers: 0
  • Slug: ZEROBOUNCE
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: ZEROBOUNCE_ACTIVITY_DATATool to get activity data (opens, clicks, etc.) for a given email. Use after confirming the email address to gauge engagement recency.Instant: Supported on the latest version.Instant pricing: Estimated $0.019 per matched Activity Data record.

Input Parameters

string
required
The email address to retrieve activity data for.

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: ZEROBOUNCE_AI_SCORING_SINGLETool to score a single email address using ZeroBounce AI. Use when you need real-time email lead quality feedback before outreach. Example prompt: “Score the email mark@gmail.com.”Instant: Supported on the latest version.Instant pricing: $0.019 per email scored.Discount: 83

Input Parameters

string
required
The email address to retrieve an AI-generated quality score for.

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: ZEROBOUNCE_ALLOW_BLOCK_LISTTool to manage allowlist and blocklist for email validation. Use when you need to programmatically add or modify custom filters before validating emails.

Input Parameters

string ("allow" | "block")
required
Action for the filter: ‘allow’ to whitelist, ‘block’ to blacklist.
string
required
The email, domain, MX record, or TLD to filter.
string ("email" | "domain" | "mx" | "tld")
required
Level to apply the filter: ‘email’, ‘domain’, ‘mx’, or ‘tld’.

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: ZEROBOUNCE_BATCH_VALIDATE_EMAILSValidate up to 200 email addresses in a real-time batch, with optional activity data on non-managed connections. Managed batch validation supports base validation only.Instant: Supported on the latest version.Instant pricing: $0.019 per email validated; unknown results are free.Discount: 83

Input Parameters

string
API key for authentication, automatically added
integer
Timeout in seconds (10–120). If exceeded, emails marked unknown/greylisted
array
required
List of up to 200 email objects to validate
boolean
Use Verify+ validation method (overrides account setting)
boolean
Include activity data in the validation results

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: ZEROBOUNCE_DELETE_AI_SCORING_FILETool to remove a completed AI scoring file from ZeroBounce servers. Use when the file status is ‘Complete’ and you need to remove it.

Input Parameters

string
required
The file ID returned from scoring sendfile API. Files can only be deleted when their status is Complete.

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: ZEROBOUNCE_DELETE_FILETool to delete a file that was submitted for bulk validation. Use when file status is ‘Complete’.

Input Parameters

string
required
The file ID returned when uploading via sendfile API.

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: ZEROBOUNCE_DOMAIN_SEARCH_FILE_STATUSTool to get the processing status of a file submitted for bulk domain search. Use after submitting the file to poll status.

Input Parameters

string
required
The ID of the domain search job returned by the sendfile API.

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: ZEROBOUNCE_DOMAIN_SEARCH_GET_FILETool to download the results file for a completed bulk domain search job. Use when you have the file_id and the job is complete.

Input Parameters

string
required
The ID of the domain search job returned by the sendfile API.

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: ZEROBOUNCE_DOMAIN_SEARCH_SEND_FILETool to upload a file for bulk domain search. Use when you have many domains in a CSV/TXT and need to lookup their details in bulk.

Input Parameters

object
required
CSV or TXT file to upload for bulk domain search. The file should contain a list of domains to search.
integer
required
1-based index of the column containing domains in the file.
boolean
Whether the first row of the file is a header 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: ZEROBOUNCE_DOMAIN_SEARCH_SINGLEIdentify common email address formats for a domain or company name. Non-managed requests can also include a person’s name for a more specific match.Instant: Supported on the latest version.Instant pricing: $0.39 per email format found; free if none is found.

Input Parameters

string
The email domain to search (e.g., ‘example.com’)
string
Person’s last name for more specific email format matching
string
Person’s first name for more specific email format matching
string
Person’s middle name for more specific email format matching
string
The company name to search if domain is not known (e.g., ‘Example Inc’)

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: ZEROBOUNCE_EMAIL_FINDER_DELETE_FILETool to delete a file that was submitted for bulk email finding. Use when the file processing status is ‘Complete’ and you need to remove it.

Input Parameters

string
required
The ID of the file to delete, returned by the email finder sendfile API

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: ZEROBOUNCE_EMAIL_FINDER_FILE_STATUSGet the processing status and progress of a file submitted for bulk email finding, using its file ID. Use this to poll an upload; a file that cannot be found is reported as an error.

Input Parameters

string
required
The file ID returned by the Email Finder send file API

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: ZEROBOUNCE_EMAIL_FINDER_SEND_FILETool to upload a file for bulk email finding. Use when you have lists of names and domains to find emails in bulk via CSV/TXT upload.

Input Parameters

string
required
Raw contents of the CSV or TXT file to upload.
string
required
Filename including extension (e.g., ‘emails.csv’).
integer
required
1-based index of the column containing domains in the file.
boolean
Whether the first row of the file is a header row.
integer
1-based index of the full name column. Either this or first_name_column is required.
integer
1-based index of the last name column (optional).
integer
1-based index of the first name column. Either this or full_name_column is required.
integer
1-based index of the middle name column (optional).

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: ZEROBOUNCE_GET_API_USAGETool to retrieve API usage statistics for a given period. Use when you need usage metrics between two dates.

Input Parameters

string
required
End date of query in YYYY-MM-DD format.
string
required
Start date of query in YYYY-MM-DD format.

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: ZEROBOUNCE_GET_CREDIT_BALANCETool to retrieve your current ZeroBounce email validation credit balance. Use when you need to monitor remaining credits to avoid service interruptions.

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: ZEROBOUNCE_GET_EMAIL_FINDER_FILETool to download the results file for a completed bulk email finder job. Use when you have the file_id and the job is complete.

Input Parameters

string
required
The file ID returned when calling email-finder/sendfile

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: ZEROBOUNCE_GET_VALIDATION_FILEDownload results for a completed primary bulk email-validation file. This read is free; processing the uploaded file is charged per email. Bulk files are limited to 50 MB and 1,000,000 records. First poll ZEROBOUNCE_GET_VALIDATION_FILE_STATUS no faster than five requests per minute (at least 12 seconds apart), and download only after file_status is Complete. This endpoint shares the five-requests-per-minute bulk limit.

Input Parameters

string
required
The completed bulk-validation file ID returned by ZEROBOUNCE_SEND_FILE.

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: ZEROBOUNCE_GET_VALIDATION_FILE_STATUSRead processing status for a primary bulk email-validation file. This read is free; processing the uploaded file is charged per email. Bulk files are limited to 50 MB and 1,000,000 records. Poll no faster than the bulk API limit of five requests per minute (at least 12 seconds apart), and call ZEROBOUNCE_GET_VALIDATION_FILE only after file_status is Complete.

Input Parameters

string
required
The bulk-validation file ID returned by ZEROBOUNCE_SEND_FILE.

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: ZEROBOUNCE_LIST_EVALUATORUpload an email list for a quality health check before full validation. Managed evaluation requires a UTF-8 CSV or TXT file of at most 1 MiB containing 100–1,000 email rows.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
Raw contents of the CSV or TXT file to upload.
string
required
Filename including extension (e.g., ‘emails.csv’).
integer
required
1-based index of the column containing email addresses.

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: ZEROBOUNCE_LIST_FILTERSRetrieve allowlist and blocklist filter rules for email addresses, domains, MX records, and top-level domains. Use to view or audit current filter rules before validation.

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: ZEROBOUNCE_SEND_FILETool to upload a file for bulk email validation. Use when you need to validate large lists of emails via CSV or TXT file.

Input Parameters

string
required
Raw contents of the CSV or TXT file to upload.
string
required
Filename including extension (e.g., ‘emails.csv’).
string
Callback URL to receive notification when file processing is complete (optional).
integer
1-based index of the column containing gender in the file (optional).
boolean
Whether the first row of the file is a header row.
integer
1-based index of the column containing the last name in the file (optional).
boolean
Whether duplicate emails should be removed before processing.
integer
1-based index of the column containing the first name in the file (optional).
integer
1-based index of the column containing IP address in the file (optional).
integer
required
1-based index of the column containing the email address in the file.

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: ZEROBOUNCE_VALIDATE_EMAILValidate a single email address in real time to check deliverability and domain details before sending emails.Instant: Supported on the latest version.Instant pricing: $0.019 per email validated; unknown results are free.Discount: 83

Input Parameters

string
required
The email address to validate.
string
Optional client IP to improve geo accuracy.
boolean
Include remaining credits info in the response.

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