- Category: email
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 12
- Triggers: 0
- Slug:
MAILFLOSS - Version: 20261101_00
Tools
Cancel Batch Verification
Cancel Batch Verification
Slug:
MAILFLOSS_CANCEL_BATCH_VERIFICATIONCancel a pending or in-progress batch verification job. This irreversible operation stops remaining work and re-credits unprocessed emails; it is a no-op if the job has already completed. Composio generates an idempotency key when omitted and preserves it for retries within this execution. Reuse a caller-supplied key for the same cancellation across separate calls.Input Parameters
Deduplication key retained for 24 hours. Composio generates one when omitted and preserves it for retries within this action execution. Supply the same key when retrying this cancellation in a separate action call. Concurrent reuse can fail with 409, and reuse with a different request can fail with 422.
Output
Check API Key
Check API Key
Create Batch Verification
Create Batch Verification
Slug:
MAILFLOSS_CREATE_BATCH_VERIFICATIONSubmit email addresses for asynchronous batch verification and return the job ID. Optionally request a completion webhook instead of polling. This billable action can fail with 402 insufficient_credits. Composio generates an idempotency key when none is supplied, so internal retries reuse the same key and email list. Separate action calls replay the cached response only when the caller reuses that key with identical emails; changing the list fails with 422, while a concurrent same-key request can fail with 409.Input Parameters
Optional HTTPS callback URL. When the batch finishes, Mailfloss sends the completed job ID and verdict summary to this URL. Omit it to poll batch status and results instead.
Deduplication key retained for 24 hours. Composio generates one when this is omitted. Supply a key and preserve the exact key and email list when retrying the same logical batch across separate action calls. Reusing it with different emails fails with 422, and a concurrent request using the same key can fail with 409. Calls that reuse a supplied key and identical emails replay the cached response for 24 hours.
Output
Erase Verification Records
Erase Verification Records
Slug:
MAILFLOSS_ERASE_VERIFICATION_RECORDSPermanently erase stored verification records for the supplied email addresses. This destructive data-privacy operation is irreversible; erased records cannot be recovered. Addresses with no stored records are a successful no-op. The body contains only the documented emails array. Composio generates an idempotency key when omitted and preserves it for retries within this execution.Input Parameters
Deduplication key retained for 24 hours. Composio generates one when omitted and preserves it for retries within this action execution. Supply the same key and exact email list when retrying an erasure in a separate action call. Concurrent reuse can fail with 409, and reuse with a different email list can fail with 422.
Output
Get Account
Get Account
Get Batch Verification Results
Get Batch Verification Results
Slug:
MAILFLOSS_GET_BATCH_VERIFICATION_RESULTSReturn one cursor-controlled page of stored batch results after organization floss-setting overrides. These statuses and reasons can differ from Verify Email’s raw verdict for the same address; fetching stored results is not documented as consuming verification credits.Input Parameters
Opaque next token returned at the top level of the prior response; omit it for the first page and pass it back unchanged.
Completed or processing batch verification job ID returned by Create Batch Verification.
Output
Get Batch Verification Status
Get Batch Verification Status
Slug:
MAILFLOSS_GET_BATCH_VERIFICATION_STATUSRead an asynchronous batch verification job’s state and available counters. Polling is not documented as consuming verification credits; authentication, policy, not-found, rate-limit, and server responses remain errors rather than job states.Input Parameters
Output
Get Verification Job
Get Verification Job
Get Organization
Get Organization
Get Usage Report
Get Usage Report
Slug:
MAILFLOSS_GET_USAGE_REPORTReturn verification usage for a UTC calendar period, optionally scoped to one ESP connection except for lifetime reports. Lifetime reports contain only the authoritative total; their range, status counts, and reason counts are null.Input Parameters
UTC calendar period. Omit to use Mailfloss’s default of this_month.
Optional public ESP connection ID. Lifetime reports are organization-wide and cannot use this filter.
Output
List Verification Jobs
List Verification Jobs
Slug:
MAILFLOSS_LIST_JOBSReturn one page of the organization’s verification-job history, newest first, with optional source and lifecycle filters. Completed jobs include verdict totals; use Get Job for the full per-reason breakdown.Input Parameters
Return only jobs submitted through this source.
Return only jobs in this lifecycle state.
Output
Verify Email
Verify Email
Slug:
MAILFLOSS_VERIFY_EMAILVerify one email address and return Mailfloss’s raw engine verdict without organization floss-setting overrides. passed means safe to send, undeliverable is a hard failure, risky covers role, disposable, bounced, or complained addresses, and unknown includes accept-all addresses and transient SMTP failures. relay and gibberish are annotations and do not alter the verdict. Each successful call consumes one verification credit; a depleted balance fails with 402 insufficient_credits, so do not retry billable failures blindly.Input Parameters
Optional provider-side verification timeout in seconds. This does not control the HTTP client timeout.