Salesforce: your first 10 minutes
This is the order to follow right after installing the package. Each step says what you should see when it worked.
The welcome guide and the checklist
The first time you connect, Tomba Setup opens a short welcome guide:
- Goals: pick what you want Tomba to do, such as finding and verifying emails on records, automation, bulk runs, companies and buying committees, data quality, or Flow, Agentforce and the API.
- Where to start: the next steps for those goals, each with a link to its guide. If you picked automation, you can turn on Verify emails when added or changed, Find missing emails and Match new records to Accounts right there.
- Monthly budget: how many credits automation may use each month. Lookups people run themselves aren't counted.
Skip closes the guide without changing anything. Reopen it any time with Setup guide in Tomba Setup › Overview.
Finish setting up, on the same page, ticks each step below once Salesforce sees it done: someone else has a Tomba permission set, someone used Tomba on a record, a job was started from a list view, someone ran a search, automation is on, and the first data-health check ran. Record pages and list buttons are page settings Tomba can't read, so you can also tick them with Mark as done. When every step is done, the card folds away.
1. Give yourself and your team access
In Setup › Permission Sets, assign Tomba Admin to yourself and to anyone who manages Tomba, and Tomba User to everyone who uses it.
You should see the Tomba Search, Tomba Bulk, Tomba Jobs and Tomba Setup tabs in the Tomba app.
2. Connect your tomba.io account
Open Tomba Setup and click Connect with Tomba, then sign in to tomba.io with the account on your Tomba Enterprise plan. Install and connect covers the API key option and what to do without an account.
You should see Connected · Enterprise in the header, your plan's search and verification credits, and step 1 of Finish setting up marked done.
3. Add Tomba to record pages and list views
- Tomba action: add it to the Lead, Contact and Account page layouts (Page Layout › Mobile & Lightning Actions).
- Tomba Insights: drag it onto the Lead, Contact and Account record pages in the Lightning App Builder, then activate the pages.
- List view button: add the Tomba button to the Lead, Contact and Account list views (Search Layouts › List View).
You should see a Tomba button in the record header and the Tomba Insights card on the side of the page.
4. Run Tomba on one record
Open a Lead or Contact with an email address, click Tomba, choose Verify email and click Run.
You should see each field Tomba can update, its current value and Tomba's value. Nothing changes until you click Save. Tomba Insights then shows the email status, its score and when it was verified.
Leads and Contacts without an email can use Find email instead, which needs a first name, a last name and a company website. See Record actions.
5. Search and import
Open Tomba Search, pick Domain search, enter a company domain and press Enter. Select a few people and click Import as Leads.
You should see the people Tomba knows at the company, each with a status and a confidence score, and In Salesforce next to the ones you imported. See Search.
6. Run Tomba on a list
Open Tomba Bulk › Salesforce records, choose Leads and Verify email, and add a condition so the run covers only a few records. Click Count records to see the most credits it can use, then Start.
You should see the job in Tomba Jobs with live progress, then Completed with the number found and the credits used. The Tomba list view button starts the same kind of job from the records you select. See Bulk jobs.
7. Optional: let Tomba work on its own
In Tomba Setup › Automation, set a Monthly credit budget and a Default monthly credit limit per user, then turn on what Tomba should do with new records, for example Verify emails when added or changed. Click Save.
Saving schedules an hourly job that runs as you. In a sandbox, automation stays off until you turn on Allow automation in this sandbox. See Automation and Sandboxes.
What uses credits
Search and verification credits are separate allowances on your plan. Nothing is charged when Tomba finds nothing.
| Action | Credits |
|---|---|
| Verify email | 1 verification credit |
| Enrich, Find email | 1 search credit |
| Find phone | Up to 5 search credits |
| Validate phone | 1 search credit |
| Domain search | 1 search credit per 10 email addresses |
| Match Leads and Contacts to Accounts | Free |
Tomba Setup › Usage shows where credits went and who used them. See Usage, limits and alerts.
If something doesn't work
- No Tomba tabs: the user has neither permission set (step 1).
- The connection is refused: the tomba.io account isn't on Tomba Enterprise yet.
- No Tomba button on a record: the action isn't on that page layout, or the record page uses a different layout (step 3).
For other messages, see the FAQ and troubleshooting.