Back to Activepieces

@activepieces/piece-validatedmails

packages/pieces/community/validatedmails/README.md

0.82.11.9 KB
Original Source

@activepieces/piece-validatedmails

ValidatedMails is an email validation API integration for Activepieces that validates a single email address and returns a consistent, flat response contract suitable for routing, scoring, and downstream decision steps.

Example workflow

  1. Trigger on a new lead submission.
  2. Run ValidatedMails → Validate Email.
  3. Branch on status (valid, invalid, unknown) to continue, reject, or review the lead.

Field guide

FieldTypeDescription
is_validbooleanFinal validity decision.
statusstringHigh-level status (valid, invalid, unknown).
scorenumberConfidence score returned by API.
reasonstringPrimary reason label.
statestringProvider state label.
emailstringSubmitted email.
normalizedstringNormalized email string.
domainstringParsed domain part.
freebooleantrue for free-provider domains.
rolebooleantrue for role-based mailboxes.
disposablebooleantrue for disposable domains.
accept_allbooleantrue when domain appears catch-all.
tagbooleantrue when plus-tagging is detected.
smtp_okbooleanSMTP signal outcome when available.
syntax_okbooleanSyntax validation result.
mx_okbooleanMX resolution result.
a_okbooleanA-record fallback result.
response_msnumberEnd-to-end API latency in milliseconds.
mx_recordstring | undefinedPrimary MX host when available.
mx_hostsstring[]MX host list returned by API.
reasonsstring[]Detailed reason list.
trace_idstringRequest identifier for support.

Authentication

Create a ValidatedMails API key in your ValidatedMails dashboard and connect it as API Key in Activepieces. Connection validation calls GET /api-keys/me.

Support

[email protected]