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

Tools

Slug: MAILERCHECK_CREATE_VERIFICATION_LISTCreate a MailerCheck verification list by ingesting a name and email-address array. Creating a one-address list did not reduce the account credit balance during live probing. This action does not invoke the separate, credit-consuming Start List Verification operation.

Input Parameters

string
required
Human-readable name for the new verification list.
array
required
One or more valid email addresses to ingest. MailerCheck does not document a maximum list size or how duplicate addresses are handled.

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: MAILERCHECK_DELETE_VERIFICATION_LISTPermanently and irreversibly delete a MailerCheck verification list by ID. Use only when the caller explicitly intends to remove the list.

Input Parameters

integer
required
ID of the verification list to permanently delete. Verify the ID before calling because deletion is irreversible.

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: MAILERCHECK_GET_CREDIT_BALANCEReturn the current MailerCheck verification-credit balance. Use this before VERIFY_EMAIL or START_LIST_VERIFICATION when cost matters.

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: MAILERCHECK_GET_CURRENT_ACCOUNTReturn the connected MailerCheck user and account identity. Use this to confirm which user and account the API token represents.

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: MAILERCHECK_GET_VERIFICATION_LISTReturn one verification list, including its status, item count, verification timing, and aggregate result statistics.

Input Parameters

integer
required
Verification-list ID returned by CREATE_VERIFICATION_LIST or LIST_VERIFICATION_LISTS.

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: MAILERCHECK_LIST_VERIFICATION_LISTSReturn one page of verification lists for the connected MailerCheck account, with an opaque cursor when another provider-controlled page exists.

Input Parameters

string
Opaque cursor returned by a previous call. Pass it unchanged to fetch the next page, or omit it for the first page.

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: MAILERCHECK_LIST_VERIFICATION_RESULTSReturn one page of email-level results for a verification list, optionally filtered by classification. The success envelope and pagination behavior are based on MailerCheck documentation and were not live-verified because producing results requires a credit-consuming list verification.

Input Parameters

integer
Requested results per page. MailerCheck documents a default of 100 but does not document a maximum, and live behavior was not verified.
string ("valid" | "catch_all" | "mailbox_full" | "role" | "unknown" | "syntax_error" | "typo" | "mailbox_not_found" | "disposable" | "blocked" | "error")
Optional exact verification classification to return.
integer
required
ID of a list whose verification has been started.
string
Opaque cursor returned by a previous call. Pass it unchanged to fetch the next page; it preserves the list ID, classification filter, and limit.

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: MAILERCHECK_START_LIST_VERIFICATIONIrreversibly start verification of every address in a MailerCheck list. A successful call spends one verification credit per address. Before calling, use GET_VERIFICATION_LIST to inspect the list count and GET_CREDIT_BALANCE to confirm the current credit_balance. This endpoint was not live-executed because the authorized verification-credit budget was exhausted.

Input Parameters

integer
required
Verification-list ID to start. This irreversible operation spends one MailerCheck verification credit per address in the list. Check the list count and current account credit_balance before calling.

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: MAILERCHECK_VERIFY_EMAILConsumes exactly one MailerCheck verification credit on every successful call. Synchronously verify one email address and return its classification; check GET_CREDIT_BALANCE first if cost matters.

Input Parameters

string
required
Email address to verify. Every successful request spends exactly one MailerCheck verification credit.

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