The Tomba API tab
The Tomba API tab shows what Salesforce uses to talk to Tomba, like the API page 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, 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.
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 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:
| 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 |
Docs and resources
The bottom of the page links to the API reference, the official libraries, rate limits, Flow actions, Agentforce actions and the status page.