sales-safetymails

What this skill does

# SafetyMails Platform Help

Help the user with SafetyMails platform questions — from bulk email verification and list cleaning through real-time API validation, Email Finder, integrations, and credit management.

SafetyMails is a Brazil-founded email verification platform with 8,000+ customers and 2B+ emails verified. ISO 27001 certified. Core strengths: bulk list cleaning (up to 2M emails), real-time JavaScript embed for form validation, and B2B corporate email finder.

## Step 1 — Gather context


If `references/learnings.md` exists, read it first for accumulated knowledge.

Ask the user:

1. **What area of SafetyMails do you need help with?**
   - A) Bulk Email Verification — upload and clean an email list
   - B) Real-Time API — JavaScript embed for forms/landing pages
   - C) Email Finder — find corporate emails by name + domain
   - D) Free Tools — single email verifier, password generator, email name generator
   - E) Integrations — RD Station, HubSpot, Mailchimp, Zapier, etc.
   - F) Reporting & Analytics — verification result breakdowns
   - G) Account & Billing — credits, pricing, plans
   - H) Something else — describe it

2. **What type of verification or lookup do you need?**
   - A) One-time list cleaning before a campaign
   - B) Ongoing form validation (real-time)
   - C) Finding corporate email addresses (Email Finder)
   - D) Checking a single email address
   - E) Not sure yet

3. **What's your goal?** (describe your specific objective — e.g., "clean 50K contacts before a Mailchimp campaign", "add real-time validation to a WordPress form", "find emails for 200 prospects")

**If the user's request already provides most of this context, skip directly to the relevant step.** Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.

## Step 2 — Route or answer directly

If the request maps to a specialized skill, route:
- General deliverability strategy (SPF/DKIM/DMARC, warmup, inbox placement) → `/sales-deliverability`
- Enrichment strategy across tools (waterfall, CRM hygiene) → `/sales-enrich`
- Building prospect lists / ICP definition → `/sales-prospect-list`
- Connecting tools via Zapier/webhooks generically → `/sales-integration`

Otherwise, answer directly from platform knowledge using the reference below.

## Step 3 — SafetyMails platform reference

Provide guidance based on the user's area:

### Bulk Email Verification
- **What it is**: Upload email lists (CSV, TXT, XLS, XLSX, or paste) and SafetyMails runs a 19-step verification algorithm on every address
- **Scale**: Up to 2M emails per list
- **Algorithm checks**: Syntax validation, MX record lookup, catch-all/accept-all detection, spamtrap identification, disposable/temporary email detection, role-based address detection (info@, sales@, etc.), domain typo correction, and more (19 steps total)
- **Credit cost**: 1 credit per email verified
- **Turnaround**: Processing time depends on list size — small lists (under 10K) typically complete in minutes
- **Output**: Downloadable results with per-email status and overall list health summary
- **Best practices**: Remove duplicate emails before uploading to save credits. Segment results by verification status before importing into your campaign tool. Re-verify lists older than 3 months — email addresses decay over time.

### Real-Time API (JavaScript Embed)
- **What it is**: A JavaScript snippet you embed in forms and landing pages to validate email addresses as users type them, before they enter your database
- **Response time**: Under 1 second
- **How it works**: Add the JavaScript embed code to your form page. Configure with your API key (generated at panel.safetymails.com). Customize error messages for invalid emails.
- **Use cases**: Landing page forms, newsletter signups, registration flows, checkout forms
- **Best practices**: Always customize error messages to match your brand voice. Use the API to prevent invalid emails from entering your CRM/ESP in the first place — this is cheaper than cleaning lists after the fact.

> **API documentation note**: SafetyMails API docs at docs.safetymails.com are help-center style guides, not a formal REST API reference. There is no comprehensive endpoint-by-endpoint reference with request/response schemas. The primary API surface is the JavaScript embed for form validation. For programmatic bulk verification, use the web panel at panel.safetymails.com or integrations. If the user needs detailed REST API documentation, flag that it may be incomplete and recommend contacting SafetyMails support.

### Email Finder
- **What it is**: B2B corporate email lookup — provide a first name, last name, and company domain, and SafetyMails returns the corporate email address
- **Credit cost**: 7 credits per found email. 1 credit if the domain is risky/unverifiable. 0 credits if no email is found.
- **Auto-verified**: Found emails are automatically verified — no need to run a separate verification step
- **Best practices**: Use for targeted prospecting when you know the person and company. Budget 7 credits per successful lookup when planning credit purchases. Combine with bulk verification for lists that mix known and unknown emails.

### Free Tools
- **Single Email Verifier**: Check one email address at a time for free on the SafetyMails website
- **Password Generator**: Generate secure passwords (utility tool)
- **Email Name Generator**: Generate professional email address suggestions from a name

### Reporting & Analytics
- **Verification results**: Detailed breakdown of your list by status category (valid, invalid, catch-all, disposable, spamtrap, etc.)
- **List health score**: Overall assessment of list quality
- **Use**: Review reports to understand the hygiene of your lists and identify patterns (e.g., high spamtrap rate may indicate a purchased or scraped list)

### Data Model — Verification Statuses

| Status | Meaning | Action |
|---|---|---|
| **Valid** | Email exists and is deliverable | Safe to send |
| **Invalid** | Email does not exist or is undeliverable | Remove immediately — sending will hard bounce |
| **Catch-All / Accept-All** | Domain accepts all addresses — cannot confirm specific mailbox | Include with caution — monitor bounce rates closely |
| **Disposable / Temporary** | Throwaway email from services like Guerrilla Mail, Mailinator | Remove — these addresses expire quickly and indicate low-intent signups |
| **Spamtrap** | Known spam trap address maintained by blocklist providers | Remove immediately — sending to spamtraps severely damages sender reputation and can get your domain blocklisted |
| **Role-Based** | Generic address like info@, sales@, support@ (not a person) | Remove from prospecting lists — these go to shared inboxes, not individuals. OK for transactional email. |
| **Syntax Error** | Malformed email address (missing @, invalid characters, etc.) | Remove — not a real email address |
| **Domain Error** | Domain does not exist or has no MX records | Remove — domain cannot receive email |

### API Quick Reference

| Feature | Details |
|---|---|
| **Primary API surface** | JavaScript embed for real-time form validation |
| **Auth** | API key generated at panel.safetymails.com |
| **Docs** | docs.safetymails.com (help-center style guides, not REST reference) |
| **Response time** | <1 second for real-time validation |
| **Bulk verification** | Via web panel upload or integrations (not a documented REST endpoint) |
| **Trial** | 1,000 API credits free for 15 days on signup |
| **API access requirement** | Monthly subscription plan required (not available on pay-as-you-go) |

### Integrations

| Integration | Type | What it does |
|---|---|---|
| **RD Station** | Marketing automation | Sync and verify contacts from RD Station |
| **SendGrid** | ESP | Verify contacts before sending via SendGrid |
| **HubSpot** |