> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesfinity.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How Email Enrichment Works

> How Salesfinity finds work and personal email addresses, where it runs, and how results and credits are handled.

Email enrichment finds an email address for a person from their LinkedIn profile. You choose the
kind of address you want:

* **Work email** — the address at the person's current employer. Use it for outbound sequences
  and CRM records.
* **Personal email** — a non-corporate address. Useful for recruiting and for reaching people who
  have changed jobs.

Each is a separate lookup with its own result and its own credit.

## Where it runs

| Surface                        | How it works                                                                                                                                                                                                             |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Sourcing tables (AI Companion) | Ask the companion for work or personal emails on a table. It shows the row count and an approval card, then fills the email column as results arrive. Each row tracks its own status: enriching, enriched, or not found. |
| Referrals captured on a call   | When a rep captures a referral during a call, Salesfinity looks for the referred person's work email so the referral can be followed up.                                                                                 |
| REST API                       | [Enrich Email](/api-reference/endpoint/enrich-email) with `type` set to `work` or `personal`, then poll or receive a callback.                                                                                           |
| MCP server                     | The `enrich_email` and `get_email_enrichment` [tools](/mcp/tools).                                                                                                                                                       |

## What happens during a lookup

<Steps>
  <Step title="The request is accepted">
    You get back a request ID with a status of pending. The lookup runs in the background; nothing
    waits on it.
  </Step>

  <Step title="The address is looked up">
    Salesfinity's data network searches for an address of the requested type. If none can be found
    for that person, the lookup resolves as not found rather than returning a guess.
  </Step>

  <Step title="The result is delivered">
    The status becomes completed with the address, or not found. In the app the row or contact
    updates in place. Through the API you poll the request ID, or Salesfinity POSTs the result to
    the callback URL you supplied, retrying up to three times if your endpoint does not answer.
  </Step>
</Steps>

## Credits

An email lookup costs **one credit only when an address is found**. Not-found results are free.
Work and personal lookups on the same person are two lookups and can cost two credits. Email and
phone enrichment share one credit pool; see [credits](/enrichment/overview#credits).

## Tips

* Give the companion the **type** you want. "Find work emails for this table" is unambiguous;
  "find emails" defaults to work.
* For a large table, enrich once and reuse. Results are stored on the row, so the table keeps
  its addresses when you come back to it.
* If you own the contact record elsewhere, use the API with a callback so your system is updated
  the moment the address is found.