Bulk Email Finder Guide
Find thousands of professional email addresses in one go by uploading your list of names and companies.
Getting Started
Navigate to the Bulks page
Click on Email Finder
Select + New Bulk, name your task, and upload your file
📄 Accepted file formats: .CSV or .TXT
👤 Your file should contain either:
Three separate columns for First Name and Last Name, Website
or One combined column (without middle names)
Creating a New Bulk Email Finder
When you click + New Bulk, you'll see the creation form:
List Name
Give your task a unique name (3-201 characters).
Upload Your File
A CSV file is required with at least 5 rows and 2 or more columns.
Column Mapping
After uploading, a preview table shows the first 10 rows. Map your columns:
First Name column (or Full Name if combined)
Last Name column (if separate from first name)
Domain / Company Website column
Company Name column (alternative to domain)
You must provide either (First Name + Last Name) or Full Name, AND either Domain or Company Name.
Options
Skip rows with existing emails — Toggle to skip rows that already contain an email address
Include sources — Toggle to include the source URLs where each email was found
Include phone numbers — Toggle to find phone numbers for each contact
Notify me when ready — Toggle to receive an email notification when complete
Limits
Maximum: 10,000 rows per file
File size must not exceed 4MB
Minimum: 5 rows required
Processing & Results
Tomba automatically validates every email it finds. Once processing is complete, you'll get an overview of:
Total emails found
Deliverability status
You can download the results in CSV format, choosing to:
Export all emails, or
Export only valid emails
Understanding the Results File
Your downloaded file will include all your original columns plus these new ones:
CSV Column | Description |
| Contact's first name |
| Contact's last name |
| The email address found by Tomba |
| Deliverability likelihood (percentage) |
| Valid, Accept all, Invalid, or Unknown |
| Up to 10 phone numbers (if phone enabled) |
If you enabled Sources, the CSV will also include Total Sources and Source1 through Source10.
Tips for Best Results
✅ Use the company’s domain instead of its full name
✅ Maximum of 10,000 rows per file (extra rows will be ignored)
✅ Avoid special characters in your data
✅ File size must not exceed 4MB
Viewing Task Results
Click on any task to view its detail page.
Progress Tracking
While your task is running:
A progress bar shows the percentage completed
A live counter displays items processed vs total
Your browser tab shows progress in the favicon
Click the bell icon to enable desktop notifications
Results Preview
Once completed, a preview table shows the first rows of results with columns:
Email — The email address found
Score — Confidence percentage with color-coded bar
Result — Verification status (Valid, Invalid, Accept all, Unknown)
Download Options
Click Download to choose:
Full list — All results including not-found rows
Valid only — Only verified valid email addresses
Task Details
A details grid displays:
Created and Expiration dates
Processing duration
Total emails found
Search cost in credits (consumed on download)
Task Actions
From the dropdown menu: Rename, Archive (or Restore), Delete.
Managing Your Bulk Tasks
You can easily manage your uploaded bulks with these features:
Sort: By task name, status, or creation date
Search: Locate specific tasks by name
Filter: Toggle between All and Archived tasks
Rename: Change task names via the dropdown menu
Archive: Move completed tasks to the archive for a cleaner view
Restore: Bring archived tasks back to the active list
Delete: Remove tasks permanently via the dropdown menu
Pagination: Choose how many tasks to display per page (10, 20, 50, 100, 150, or 200)
LinkedIn Email Finder for Microsoft Excel
Tomba’s Excel Add-on helps you extract professional email addresses using LinkedIn profile URLs directly within Excel.
How to Use It:
Open your Excel file containing contact data.
Ensure the file includes at least the following columns:First Name
Last Name
Company Name or Domain Name
(For best results, include all four fields.)
Navigate to the Finder tab in the Tomba Excel Add-on.
Map your columns to the corresponding contact fields.
If your table has headers, check the "My table has headers" box.
Click "Find email addresses" to start enriching your contacts.
Enrich Your Data with Email Addresses Using the Google Sheets Add-on
Tomba’s Google Sheets Add-on helps you enrich your contact list by finding professional email addresses using the first name, last name, and either the company name or domain name.
How to Use It:
Open your Google Sheet containing your contacts.
Your sheet should include at least:First Name
Last Name
Company Name or Domain Name
(For the best accuracy, include all four fields.)
Go to the Finder tab in the Tomba add-on.
Match your columns to the required contact fields.
Check the "My table has headers" box if your sheet includes header rows.
Click "Find email addresses".
What Happens Next:
Tomba will populate the sheet with the email addresses found for each contact.
Two new columns will be added:
Confidence Score – indicating the accuracy of the match.
Status – showing the result of the search.
Possible Statuses:
OK – A valid email address was found.
No results – No email address could be found.
Parameter(s) missing – Required fields (first name, last name, company/domain) were missing and the lookup couldn’t be completed.
Using The Email Finder via API
Generates or retrieves the most likely email address from a domain name, a first name and a last name.
from tomba.client import Clientfrom tomba.services.finder import Finder# Initialize the Tomba clientclient = Client()client.set_key('ta_xxxx').set_secret('ts_xxxx')# Initialize the Email Finder servicefinder = Finder(client)# Find the email address for a specific personresult = finder.email_finder('stripe.com', 'fname', 'lname')
Available SDKs
Tomba offers official SDKs for many popular programming languages, including:
PHP, Python, C#, Go, Rust, Ruby, Dart, JavaScript, R, Lua, Elixir, and more.
Task Progress Tracking
While your bulk task is processing:
A progress bar shows the percentage completed
A live counter displays items processed vs total items
Your browser tab updates with the progress percentage in the favicon
Click the bell icon to enable desktop notifications — you’ll be notified when your task finishes
Task Statuses
Each bulk task goes through one of the following statuses:
Pending — Task is queued, not yet started
Running — Currently being processed
Completed — Results are ready to download
No Result — Completed but no results were found
Failed — Task terminated with an error
Cancelled — Stopped by user or system
Expired — Data retention period has passed, results are no longer available
Task Details
Each completed task displays:
Created date and expiration date
Processing duration
Total results found
Total items processed
Verification status and cost (if verification was enabled)
Search cost in credits
Credits & Upgrade
Credits are only consumed when you download the results
If you don’t have enough credits, an upgrade prompt will appear with a link to upgrade your plan
Team members will see a notice if the team owner needs more credits
Related Resources
Bulk Operations Overview — All bulk tools in one place
Bulk API Reference — API documentation for bulk endpoints
Pricing & Plans — View plans and credit allowances
How Credits Work — Understand credit usage for bulk operations
Email Finder API — API reference for email finder
LinkedIn Email Finder — Find emails from LinkedIn profiles
LinkedIn Finder API — API reference for LinkedIn finder
Tomba CLI Documentation — Command-line interface reference







