# The Tomba API tab

The **Tomba API** tab shows what Salesforce uses to talk to Tomba, like the [API page](https://app.tomba.io/api) of the
Tomba web app. It's for users with the **Tomba Admin** permission set, and nothing on it uses credits.

## Keys

**This org's connection** shows the API key Salesforce calls Tomba with:

- the first characters of the key, and its name in your workspace;
- when it expires, and **Renews automatically** when Tomba created it while you connected with Tomba;
- how Salesforce is connected (Tomba sign-in or a pasted API key) and when the key was last used.

**Test connection** calls Tomba with the key and shows how long it took to answer, or the error.

**Rotate now** gives the key a new value and a new year, and saves it in Salesforce. The old value stops working at
once, so update anything else that uses the same key. It's only offered for the key Tomba created when you connected
with Tomba: a key you pasted in Tomba Setup is rotated on [app.tomba.io](https://app.tomba.io/api), then pasted again
in **Tomba Setup**.

**Workspace API keys** lists every key of your Tomba workspace with its name, who made it, when it expires (keys that
expire within 30 days are highlighted) and when it was last used. The one Salesforce uses is marked **Used by this
org**.

Key values never reach the browser: the page shows only their first characters, like Tomba Setup. The values stay in
the encrypted External Credential. Create, rename, reset and delete keys on [app.tomba.io](https://app.tomba.io/api).

## Rate limits

For each endpoint Salesforce calls, the page shows how many requests per second your plan allows, and bars for this
minute and today. Use is counted across your whole Tomba workspace, Salesforce included, and daily counts reset at
00:00 UTC. A plan without limits shows **No rate limits on your plan**. Click **Refresh** to read them again.

See [Rate limits](/rate-limits) for the response headers and how to handle a `429`.

## Endpoints

**Endpoints** lists the Tomba API endpoints each Salesforce feature calls, the credit a lookup takes and a link to the
endpoint in the [API reference](/api):

| Endpoint                                  | Used by                                                                          | Credits                       |
| ----------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------- |
| `/v1/email-finder`                        | Find email on records, Search, Bulk, automation, Flow and Agentforce             | 1 search credit               |
| `/v1/email-verifier`                      | Verify on records, Search, Bulk, automation, Clean › Verify, Flow and Agentforce | 1 verification credit         |
| `/v1/domain-search`                       | Search › Domain search, Bulk, buying committee                                   | 1 search credit               |
| `/v1/enrich`                              | Enrich on records, Search, Bulk, automation                                      | 1 search credit               |
| `/v1/linkedin`, `/v1/author-finder`       | Search, Bulk                                                                     | 1 search credit               |
| `/v1/phone-finder`, `/v1/phone-validator` | Search, Bulk; phone validation also in Clean › Verify                            | 1 search credit               |
| `/v1/companies/find`                      | Search › Company enrichment, Bulk                                                | 1 search credit               |
| Other Search tools                        | Companies, similar companies, technologies, email count, format and sources      | See the [API reference](/api) |

## Docs and resources

The bottom of the page links to the [API reference](/api), the [official libraries](/libraries),
[rate limits](/rate-limits), [Flow actions](/salesforce/flow-actions), [Agentforce actions](/salesforce/agentforce) and
the [status page](https://status.tomba.io).
