Bulk Email Enrichment
Use the Bulk Email Enrichment tool to upload a list of email addresses and retrieve detailed professional and company information all in one place.
How to Use Bulk Email Enrichment
Go to the Bulks page
Click on Bulk Email Enrichment
Click + New Bulk, name your task
Upload your file containing email addresses
📄 Accepted file formats: .CSV or .TXT
✅ All email addresses must be in a single column
💡 Tip: Before uploading, open your file in a spreadsheet tool like Microsoft Excel, Google Sheets, or OpenOffice Calc, and save it as a properly formatted CSV to avoid errors.
What You’ll Get (Fields Enriched)
For each email, Tomba may return:
CSV Column | Description |
| The email address enriched |
| Company domain |
| Company name |
| Deliverability likelihood (percentage) |
| Valid, Accept all, Invalid, or Unknown |
| Personal or Generic |
| Email pattern used |
| Contact's first name |
| Contact's last name |
| Job title |
| Department |
| Twitter profile |
| LinkedIn profile |
| Contact's country |
| Up to 10 phone numbers |
If you enabled Sources, the CSV will also include Total Sources and Source1 through Source10.
Understanding Your Results
Tomba automatically validates each email address. Once processing is complete:
View total number of valid emails
Download the complete results in CSV format
Choose to export all results or only valid emails
Creating a New Bulk Email Enrichment
When you click + New Bulk:
List Name
Give your task a unique name (3-201 characters).
List Content
Enter email addresses one per line in the text area, or upload a .CSV or .TXT file.
All emails must be in a single column
Maximum: 10,000 email addresses per bulk
File size must not exceed 4MB
CSV Column Mapping
For multi-column CSV files, a preview shows the first 10 rows. Click on the column containing your email addresses to select it.
Options
Notify me when ready — Toggle to receive an email notification when complete
Viewing Task Results
Click on any task to view its detail page.
Progress Tracking
While processing: progress bar with percentage, live counter, browser tab favicon badge, and desktop notifications (bell icon).
Results Preview
A preview table shows the first rows with: Email, Job Title, Social Profiles (LinkedIn, Twitter), Gender, Location, and Sources.
Download Options
Click Download to choose:
Full list — All enriched results
Valid only — Only successfully enriched email addresses
Task Details
Details grid shows: Created and Expiration dates, Processing duration, Total emails enriched, Search cost in credits.
Task Actions
From the dropdown menu: Rename, Archive (or Restore), Delete.
Managing Your Bulk Tasks
Each uploaded task can be managed with the following actions:
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)
Enrich your Emails Via Microsoft Excel Add-in
Tomba for Microsoft excel can enrich your existing data by finding email addresses using first name, last name, and company website or company name.
Open a Microsoft excel file with emails only
Select the Enrichment tab.
Match the contact fields to your corresponding columns.
Check the My table has headers box if needed.
Click on "Enrich".
Enrich your URLs Via Google Sheets Add-on
Tomba for Google Sheets can enrich your existing data by finding email addresses using first name, last name, and company website or company name.
Open a Google Sheet fileemails only
Select the Enrichment tab.
Match the contact fields to your corresponding columns.
Check the My table has headers box if needed.
Click on "Enrich".
Tomba will automatically populate the sheet with the email addresses found for each contact.
In addition, it will add two extra columns:
Confidence Score – indicates how likely the found email is accurate.
Status – shows the result of each lookup.
Possible Status Values:
OK – A valid email address was successfully found.
No results – No email address could be found for the given information.
Parameter(s) missing – One or more required fields (First Name, Last Name, Company/Domain) are missing, preventing the search from being processed.
Using the Email Enrichment via API
Look up person and company details using just an email address with Tomba’s Email Enrichment API.
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 (Enrichment) servicefinder = Finder(client)# Enrich data based on email addressresult = finder.enrichment('[email protected]')
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 — Find professional email addresses
Email Finder API — API reference for email finder
LinkedIn Email Finder — Find emails from LinkedIn profiles
LinkedIn Finder API — API reference for LinkedIn finder