Create Lead
Create a new lead in Tomba's lead database. Use this to store contact information for a person you want to track. Returns the unique ID of the created lead. Required fields: first_name, email. All other fields are optional.
Tomba is an Email Finder for B2B sales and email marketing.
Create a new lead in Tomba's lead database. Use this to store contact information for a person you want to track. Returns the unique ID of the created lead. Required fields: first_name, email. All other fields are optional.
Tool to delete an API key by its numeric ID. Use when you need to permanently revoke an API key before its expiration. Note: You can get the numeric key ID from the TOMBA_KEYS_LIST action.
Tool to delete a leads list by ID. Use when you need to permanently remove a list after confirming its ID.
Tool to check if a domain is webmail or disposable. Use when validating email deliverability constraints.
Enrich one company from its domain; this does not look up a specific person. A successful lookup costs 1 search credit, while no result costs no credit. Shared limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On 429, retry after the number of seconds in the Retry-After header.
Enrich one person from an email address; use the company or combined actions for company-only or one-call person-and-company data. A successful lookup costs 1 search credit, while no result costs no credit; included email verification is free. Shared limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On 429, retry after the number of seconds in the Retry-After header.
Enrich both a person and their company from one email in one request; use the focused actions when only one entity is needed. A successful lookup costs 1 search credit, while no result costs no credit; included email verification is free. Shared limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On 429, retry after the number of seconds in the Retry-After header.
Find an article author's professional contact data from its URL. A successful email or article-author name costs 1 Searches credit; an unsuccessful no-result request is free. Shared plan limits are Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, honor Retry-After before retrying.
Find the most likely professional email from a LinkedIn profile URL, optionally returning all associated emails and mobile phone data. Each successful email costs 1 Searches credit; an unsuccessful no-result request is free. Shared plan limits are Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, honor Retry-After before retrying.
Find phone numbers by providing at least one of email, domain, or LinkedIn URL. A lookup costs 5 credits and returns up to 10 phone numbers; unsuccessful or no-result lookups are not charged. Shared plan limits are Free: 1 rps, 2 rpm, 5 daily; Basic: 3 rps, 50 rpm, 500 daily; Growth: 5 rps, 80 rpm, 1,000 daily; Pro: 8 rps, 150 rpm, 4,000 daily; PAYG 20k: 10 rps, 200 rpm, 4,000 daily; and 50k+ plans: unlimited. On HTTP 429, retry after the provider's Retry-After value.
Find a professional email from company and person identifiers, optionally including an associated mobile phone number. A successful email result costs 1 Searches credit; an unsuccessful no-result request is free. Shared plan limits are Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, honor Retry-After before retrying.
Return contact counts and department breakdown for a domain. Each domain lookup costs 1 credit. Rate limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, retry after the Retry-After header delay.
Return detected email patterns for a domain. This helper is free according to the current credit table (no listed credit charge). Rate limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, retry after the Retry-After header delay.
Return public web sources where an email address was found. Each email source lookup costs 1 credit; unsuccessful or no-result lookups are not charged. Shared plan limits are Free: 1 rps, 2 rpm, 5 daily; Basic: 3 rps, 50 rpm, 500 daily; Growth: 5 rps, 80 rpm, 1,000 daily; Pro: 8 rps, 150 rpm, 4,000 daily; PAYG 20k: 10 rps, 200 rpm, 4,000 daily; and 50k+ plans: unlimited. On HTTP 429, retry after the provider's Retry-After value.
Return employee counts by country for a domain. This helper is free according to the current credit table (no listed credit charge). Rate limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, retry after the Retry-After header delay.
Tool to get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.
Tool to list all API keys. Use when you want to retrieve information about your existing Tomba API keys.
Retrieves all custom lead attributes defined in your Tomba account. Use this action to discover the available attributes that can be used when creating or updating leads. Returns attribute metadata including name, identifier, type, and timestamps. No input parameters required.
Tool to list all lead lists. Use when you need to retrieve and paginate your lead lists.
Tool to list all leads. Use when you need to retrieve and paginate your leads list.
Search a domain or company for professional contacts, optionally including mobile phone enrichment. Each request costs 1 credit per up to 10 returned emails; no-result searches cost no credit. Rate limits: Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, retry after the Retry-After header delay.
Tool to update a leads list's name by ID. Use when renaming an existing list after obtaining its ID.
Validate and format a phone number. Validation costs 1 credit per phone; unsuccessful or no-result lookups are not charged. Shared plan limits are Free: 1 rps, 2 rpm, 5 daily; Basic: 3 rps, 50 rpm, 500 daily; Growth: 5 rps, 80 rpm, 1,000 daily; Pro: 8 rps, 150 rpm, 4,000 daily; PAYG 20k: 10 rps, 200 rpm, 4,000 daily; and 50k+ plans: unlimited. On HTTP 429, retry after the provider's Retry-After value.
Verify email deliverability and mailbox signals, optionally returning an associated mobile phone number. A successful verification costs 1 Verifications credit; an unsuccessful no-result verification is free. Shared plan limits are Free 1 rps/2 rpm/5 daily; Basic 3/50/500; Growth 5/80/1000; Pro 8/150/4000; PAYG 20k 10/200/4000; 50k+ unlimited. On HTTP 429, honor Retry-After before retrying.
Verify up to 1000 emails by managing Tomba's asynchronous bulk job synchronously. The temporary provider job is always deleted after the attempt, so the action has no lasting external mutation after cleanup; the provider does not offer atomicity across create, launch, poll, download, and delete. Each email consumes one verification credit. Account-plan rate limits apply to every lifecycle request.
The Tomba integration connects your Dench AI CRM directly to Tomba, so agents can read and act on your Tomba data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
25 actions are available for agents to invoke on your behalf. Every call runs through Tomba's own authorization, scoped to the account you connect.
Sign in to your Dench workspace and open Integrations.
Find Tomba and click Connect — you'll authorize access through Tomba's own sign-in flow. No API keys or code required.
Ask an agent to use Tomba in chat, or call it from an automation.
Manage or disconnect the connection any time from workspace settings.
The Dench Tomba integration connects your AI CRM to Tomba, so AI agents can work with your Tomba data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
The Tomba integration currently exposes 25 actions, including Create Lead, Delete API Key by ID, Delete Leads List by ID, Domain Status, Enrich Company, and Enrich Person. Agents invoke them on your behalf from chat or from automations.
No. You connect Tomba from your Dench workspace using Tomba's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Connections are authorized through Tomba's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Tomba connection from your workspace settings at any time.