anti-tempmail_skill

Overview

This skill integrates AntiTempMail to validate email addresses and detect temporary/disposable providers. It helps block throwaway accounts, reduce fraud, and improve data quality for registrations and mailing lists. The skill supports single and bulk checks and returns risk and provider details for each address.

How this skill works

The skill sends email addresses to the AntiTempMail API and receives structured results indicating whether an address is temporary, its domain, provider, risk level, and confidence score. It supports single-email checks and bulk checks (up to 100 emails per request) and honors API rate limits and caching behavior. Responses include summary counts for bulk requests to simplify filtering and reporting.

When to use it

• Validate emails during user registration to prevent throwaway accounts.
• Clean or deduplicate marketing and newsletter lists before sending campaigns.
• Enforce security or fraud-detection rules that depend on email legitimacy.
• Bulk-scan existing databases to improve customer data quality and reduce bounce rates.

Best practices

• Store your API key as an environment variable and avoid hardcoding it in source files.
• Run a single-email check synchronously during sign-up, and use bulk checks for periodic list cleanups.
• Honor rate limits: batch requests up to 100 emails and implement exponential backoff on 429 responses.
• Use the returned risk and confidence fields to create policy thresholds (e.g., block high-risk, flag medium-risk for review).
• Cache positive/negative results for 24 hours to reduce repeat calls and conserve quota.

Example use cases

• Block registration when isTemporary is true and risk is high to reduce spam accounts.
• Automatically remove or flag temporary addresses from marketing lists using the bulk endpoint.
• Combine risk and confidence to route suspicious sign-ups to manual review instead of immediate rejection.
• Embed a lightweight client-side check for format and then call the API server-side for final validation during checkout or form submission.