# Salesforce: your first 10 minutes

This is the order to follow right after [installing the package](/salesforce/installation). 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**:

1. **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.
2. **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.
3. **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](/salesforce/installation#4-connect-your-tomba-enterprise-account) 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](/salesforce/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](/salesforce/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](/salesforce/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](/salesforce/automation) and [Sandboxes](/salesforce/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](/salesforce/usage-and-limits).

## 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](/salesforce/faq).
