AI Agents

Email verification for your AI agents

Give Claude Code, Codex, or any agent that can run shell commands the ability to verify single addresses and clean entire lists.

Get Started Free

Includes 250 free credits
Verify the emails in leads.csv and tell me which ones are safe to send to. Bash emailable batch verify leads.csv --wait --json { "emails": [ {… +7201 lines (ctrl+o to expand) 268 of the 312 emails are Deliverable and safe to send to. 17 are Risky and 27 are Undeliverable. Want me to save the Deliverable ones to a new file? Yes, save them to clean-leads.csv. Write clean-leads.csv Wrote 268 lines to clean-leads.csv Done. clean-leads.csv has all 268 Deliverable addresses. What's the difference between risky and undeliverable? Undeliverable addresses will bounce, so you should remove them. Risky addresses might accept mail but have problems, like catch-all domains or low quality inboxes, so sending to them can hurt your sender reputation. Why did my email to john.smith@gmial.com bounce? Bash emailable verify john.smith@gmial.com --json { "accept_all": null, "birth_year": null,… +21 lines (ctrl+o to expand) The address is Undeliverable because gmial.com is a typo. Did you mean john.smith@gmail.com? Now verify crm-export.csv. The email column is called Email Address. Bash emailable batch verify crm-export.csv --field "Email Address" --wait -o crm-verified.csv --json Done. All 1,204 contacts are verified, and the results are in crm-verified.csv. Add email verification to our import script. Update scripts/import.sh Updated scripts/import.sh with 4 additions and 1 removal Done. scripts/import.sh now verifies each file with Emailable and skips Undeliverable addresses before importing. How many credits do I have left? Bash emailable account status --json { "owner_email": "john@smith.com", "available_credits": 46733} You have 46,733 credits left.

Get up and running in just two steps

The skill teaches your agent how to verify emails, read the results, and recover from errors. Once it's installed, just ask.

  1. 1

    Install the CLI

    Runs on macOS, Linux, WSL2, and Windows.

    Terminal 
    curl -fsSL https://emailable.com/install-cli | bash
  2. 2

    Run emailable

    The first run signs you in through your browser and offers to install the skill for Claude Code, Codex, and OpenCode.

    Terminal 
    emailable
$ emailable ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⣴⣶⣾⣿⣿⣿⣿⣿⣿⣷⣶⣦⣤⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣿⣿⣿⣿⡿⠿⠿⠿⣿⣿⣿⣿⣿⣿⣿⣷⣤⡀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⣠⣶⣿⣿⣿⣿⡿⠛⠋⠉⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠛⠿⣿⣿⣿⣿⣷⣄⠀⠀⠀⠀ ⠀⠀⢀⣼⣿⣿⣿⡿⠛⠁⠀⠀⠀⠀⢀⣀⣠⣤⣤⣤⣀⣀⠀⠀⠀⠀⠈⠙⢿⣿⣿⣿⣷⡀⠀⠀ ⠀⢠⣾⣿⣿⣿⠟⠀⠀⠀⠀⣠⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣶⣄⠀⠀⠀⠀⠹⣿⣿⣿⣿⡄⠀ ⢀⣿⣿⣿⣿⠃⠀⠀⠀⣠⣾⣿⣿⣿⡿⠟⠛⠛⠛⠛⠻⢿⣿⣿⣿⣷⣄⠀⠀⠀⠘⣿⣿⣿⣿⡄ ⣼⣿⣿⣿⡏⠀⠀⠀⢰⣿⣿⣿⡿⠋⠀⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣿⣿⣆⠀⠀⠀⠸⣿⣿⣿⣷ ⣿⣿⣿⣿⠁⠀⠀⠀⣿⣿⣿⣿⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⣿⣿⣿⣿⠀⠀⠀⠀⣿⣿⣿⣿ Emailable ⣿⣿⣿⣿⠀⠀⠀⠀⣿⣿⣿⣿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⠀⠀⠀⠀⣿⣿⣿⣿ ⢻⣿⣿⣿⡇⠀⠀⠀⠸⣿⣿⣿⣷⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣆⡀⠀⢰⣿⣿⣿⡿ ⠈⣿⣿⣿⣿⡄⠀⠀⠀⠙⢿⣿⣿⣿⣷⣦⣤⣀⣀⣠⣤⣄⠀⠀⠘⢿⣿⣿⣿⣿⣷⣿⣿⣿⣿⠃ ⠀⠘⣿⣿⣿⣿⣆⠀⠀⠀⠀⠙⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡄⠀⠀⠉⠛⠿⣿⣿⣿⣿⣿⠏⠀ ⠀⠀⠈⢿⣿⣿⣿⣷⣄⡀⠀⠀⠀⠀⠉⠙⠛⠛⠛⠛⠋⠉⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠿⠃⠀⠀ ⠀⠀⠀⠀⠙⢿⣿⣿⣿⣿⣶⣤⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⠈⠻⢿⣿⣿⣿⣿⣿⣿⣷⣶⣶⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠛⠿⠿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ Welcome to Emailable The command-line interface for Emailable. Let's get you logged in — this only takes a moment. Opening your browser to authorize. Verification code: QHRT-KMXV If it doesn't open, visit https://app.emailable.com/oauth/device?user_code=QHRT-KMXV ✓ Logged in as john@smith.com Using an AI coding agent? We can install a skill so it knows how to verify emails with this CLI. ✓ Skill installed to ~/.agents/skills/emailable Linked into agent locations: • Claude Code (Global) → ~/.claude/skills/emailable • Codex (Global) → ~/.codex/skills/emailable • OpenCode (Global) → ~/.config/opencode/skill/emailable NEXT STEPS emailable verify hello@example.com Verify a single address emailable batch verify emails.csv --wait Verify a CSV in bulk emailable account status Check your credit balance

Works with the agents you already use

Claude Code, Codex, and OpenCode are set up automatically. Everything else just needs a shell.

View the CLI docs View on GitHub
  • Claude Code logo

    Claude Code
  • Codex logo

    Codex
  • OpenCode logo

    OpenCode

  • Any other agent

Ask in plain English

Your agent turns a request into the right Emailable command, reads the results, and tells you what it found.

  • Verify an address

    Is john.smith@gmail.com a real address? Bash emailable verify john.smith@gmail.com --json { "accept_all": null, "birth_year": null,… +21 lines (ctrl+o to expand) Yes. john.smith@gmail.com is Deliverable with a score of 100. It's a free Gmail address and isn't a role or disposable address.

  • Clean a list

    Check the addresses in signups.txt before I import them. Bash emailable batch verify signups.txt --wait --json { "emails": [ {… +94 lines (ctrl+o to expand) Only john.smith@gmail.com is safe to import. tim@smith.con has a typo in the domain and johndoe@mailinator.com is a disposable address. Want me to remove them?

  • Find Risky addresses

    Which addresses in newsletter.csv are risky? Bash emailable batch verify newsletter.csv --wait --jq '.emails[] | select(.state == "risky") | .email' info@smith.comsales@smith.comtim.smith@yahoo.com These 3 are Risky. They might accept mail, but sending to them can hurt your sender reputation. Want me to move them to a separate file?

  • Export results

    Verify signups.csv and save the results so I can open them in a spreadsheet. Bash emailable batch verify signups.csv --wait -o results.csv --json Done. All 842 results are in results.csv.

Built for agents, scripts, and scheduled jobs

The same CLI your agent uses works in shell scripts, scheduled jobs, and data pipelines.

  • JSON on every command

    Every command can return JSON that matches the Emailable API field for field.

  • Filter to what you need

    Pull out just the results you want, like only the Deliverable addresses, without any extra tools.

  • Predictable errors

    Every error has a stable code and exit status, so agents and scripts can recover without parsing messages.

  • Safe retries

    Rate limits and temporary failures retry automatically, and a batch is never submitted twice.

  • Keys stay out of your history

    Sign in through your browser, or use an API key for scripts and scheduled jobs. Your key never has to appear on the command line.

  • Works with files and pipes

    Read addresses from CSV, JSON, or text files, or pipe them in. Save results as CSV or JSON, or send them to a webhook.

Frequently Asked Questions

Other ways to verify

Explore other ways you can use email verification in your business and elevate your email deliverability.

  • An email verification API request and its JSON response

    Email Verification API

    Integrate our Email Verification API and filter invalid email addresses directly on your website, landing pages, or in your application.

    Explore the Email Verification API
  • A bulk email list overview with verification results

    Bulk Email Verifier

    Need to verify a list of emails? Upload from your computer, copy and paste, or connect an integration to quickly import and verify entire lists of emails at once.

    Explore the Bulk Email Verifier
  • Email verifier results for a single address

    Email Verifier

    Need to check the validity of a few emails? Type them into the fastest and most accurate email checker and find out in seconds.

    Explore the Email Verifier

Join the world's largest companies that rely on Emailable to protect their sender reputation

Get Started Free

Includes 250 free credits