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 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 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.

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.

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 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 list all API keys. Use when you want to retrieve information about your existing Tomba API keys.

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 list all leads. Use when you need to retrieve and paginate your leads list.

Tool to delete a leads list by ID. Use when you need to permanently remove a list after confirming its ID.

Tool to list all lead lists. Use when you need to retrieve and paginate your lead lists.

Tool to update a leads list's name by ID. Use when renaming an existing list after obtaining its ID.

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 get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.

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.