> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tomba

> Tomba is an Email Finder for B2B sales and email marketing.

![Tomba logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/tomba.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=00b3aa3e28faf5232a38489a64f9d53d)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 25
* **Triggers:** 0
* **Slug:** `TOMBA`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] List Lead Attributes
>
> **Slug:** `TOMBA_ATTRIBUTES_LIST`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Domain Status
>
> **Slug:** `TOMBA_DOMAIN_STATUS`
>
> Tool to check if a domain is webmail or disposable. Use when validating email deliverability constraints.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.008 per provider-reported credit; the request debit depends on the operation and returned results.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> The domain name to check the status for (e.g., 'gmail.com')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich Company
>
> **Slug:** `TOMBA_ENRICH_COMPANY`
>
> Enrich one company from its domain; this does not look up a specific person. Charged only when a result is found; no-result lookups are 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.008 per successful lookup; no result is free
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Company domain to enrich, without a URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich Person
>
> **Slug:** `TOMBA_ENRICH_PERSON`
>
> Enrich one person from an email address; use the company or combined actions for company-only or one-call person-and-company data. Charged only when a result is found; no-result lookups are free, and the included email verification adds no charge. 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.017 per successful person enrichment
>
> **Discount:** 91
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Professional email address of the person to enrich.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich Person and Company
>
> **Slug:** `TOMBA_ENRICH_PERSON_AND_COMPANY`
>
> Enrich both a person and their company from one email in one request; use the focused actions when only one entity is needed. Charged only when a result is found; no-result lookups are free, and the included email verification adds no charge. 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.008 per successful lookup; no result is free
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Professional email address used to enrich both person and company.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Article Author
>
> **Slug:** `TOMBA_FIND_AUTHOR`
>
> Find an article author's professional contact data from its URL. Charged only when an email or article-author name is found; no-result requests are 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.017 per successful author-email find
>
> **Discount:** 91
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Public article URL whose author should be identified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Professional Email
>
> **Slug:** `TOMBA_FIND_EMAIL`
>
> Find a professional email from company and person identifiers, optionally requesting an associated mobile phone number on non-managed calls. No-result requests are free.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.017 per successful email find
>
> **Discount:** 91
>
> #### Input Parameters
>
> **domain** `string`
>
> Company domain, such as stripe.com. Either domain or company is required; domain takes precedence when both are provided.
>
> **company** `string`
>
> Company name. Either company or domain is required.
>
> **full\_name** `string`
>
> Person's full name. Provide this or both first\_name and last\_name.
>
> **last\_name** `string`
>
> Person's last name. Required with first\_name when full\_name is omitted.
>
> **first\_name** `string`
>
> Person's first name. Required with last\_name when full\_name is omitted.
>
> **enrich\_mobile** `boolean`
>
> Set true to request an associated mobile phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Email From LinkedIn
>
> **Slug:** `TOMBA_FIND_EMAIL_FROM_LINKEDIN`
>
> Find the most likely professional email from a LinkedIn profile URL, optionally requesting all associated emails and, on non-managed calls, mobile phone data. No-result requests are free.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.017 per successful LinkedIn email find
>
> **Discount:** 91
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Full LinkedIn profile URL.
>
> **full** `boolean`
>
> Set true to return all emails associated with the LinkedIn profile instead of only the most likely email.
>
> **enrich\_mobile** `boolean`
>
> Set true to request associated mobile phone data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Phone Numbers
>
> **Slug:** `TOMBA_FIND_PHONE`
>
> Find phone numbers by providing at least one of email, domain, or LinkedIn URL. A successful lookup 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.089 per successful phone lookup returning up to 10 phones
>
> **Discount:** 91
>
> #### Input Parameters
>
> **full** `boolean`
>
> Whether to return all associated phone numbers instead of only the primary result.
>
> **email** `string`
>
> Email address to search. At least one of email, domain, or linkedin is required.
>
> **domain** `string`
>
> Company domain to search. At least one of email, domain, or linkedin is required.
>
> **linkedin** `string`
>
> LinkedIn profile URL to search. At least one of email, domain, or linkedin is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Domain Email Count
>
> **Slug:** `TOMBA_GET_EMAIL_COUNT`
>
> 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.008 per domain lookup
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain whose available professional email counts should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Domain Email Formats
>
> **Slug:** `TOMBA_GET_EMAIL_FORMAT`
>
> Return detected email patterns for a domain. Free; no 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.008 per provider-reported credit; the request debit depends on the operation and returned results.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain whose detected professional email patterns should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Sources
>
> **Slug:** `TOMBA_GET_EMAIL_SOURCES`
>
> 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.008 per successful lookup; no result is free
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address whose public web sources should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Employee Locations
>
> **Slug:** `TOMBA_GET_EMPLOYEE_LOCATIONS`
>
> Return employee counts by country for a domain. Free; no 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Estimated \$0.008 per provider-reported credit; the request debit depends on the operation and returned results.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain whose employee distribution by country should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete API Key by ID
>
> **Slug:** `TOMBA_KEYS_DELETE`
>
> 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.
>
> #### Input Parameters
>
> **key\_id** `string` *required*
>
> The numeric ID of the API key to delete. This is the 'id' field returned by the keys list endpoint, not the key string itself.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List API Keys
>
> **Slug:** `TOMBA_KEYS_LIST`
>
> Tool to list all API keys. Use when you want to retrieve information about your existing Tomba API keys.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Lead
>
> **Slug:** `TOMBA_LEADS_CREATE`
>
> 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.
>
> #### Input Parameters
>
> **city** `string`
>
> City where the lead is located
>
> **tags** `array`
>
> List of tags to categorize or label the lead for organization
>
> **email** `string` *required*
>
> Lead's email address (required). Must be a valid email format
>
> **phone** `string`
>
> Lead's phone number, including country code if international
>
> **state** `string`
>
> State or province where the lead is located
>
> **company** `string`
>
> Company or organization the lead works for
>
> **country** `string`
>
> Two-letter ISO 3166-1 alpha-2 country code. Must use the code format, not full country name
>
> **twitter** `string`
>
> Full Twitter/X profile URL
>
> **website** `string`
>
> Lead's personal or company website URL
>
> **linkedin** `string`
>
> Full LinkedIn profile URL
>
> **position** `string`
>
> Lead's job title or position
>
> **last\_name** `string`
>
> Lead's last name. If provided, must not be empty
>
> **first\_name** `string` *required*
>
> Lead's first name (required)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Leads
>
> **Slug:** `TOMBA_LEADS_LIST`
>
> Tool to list all leads. Use when you need to retrieve and paginate your leads list.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (1-indexed). Defaults to 1 if not specified.
>
> **limit** `integer`
>
> Number of leads per page (1-100). Defaults to 10 if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Leads List by ID
>
> **Slug:** `TOMBA_LISTS_DELETE`
>
> Tool to delete a leads list by ID. Use when you need to permanently remove a list after confirming its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique numeric identifier of the leads list to delete. Obtain this ID from the lists list action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Lead Lists
>
> **Slug:** `TOMBA_LISTS_LIST`
>
> List your Tomba lead lists, with optional page and page-size controls. Page numbers start at 1, and the page size can be between 1 and 100.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **limit** `integer`
>
> Number of items per page, between 1 and 100
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Leads List
>
> **Slug:** `TOMBA_LISTS_UPDATE`
>
> Tool to update a leads list's name by ID. Use when renaming an existing list after obtaining its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Numeric ID of the leads list to update (obtain from TOMBA\_LISTS\_LIST action)
>
> **name** `string` *required*
>
> New name for the leads list. Must be unique across all lists in the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Domain Contacts
>
> **Slug:** `TOMBA_SEARCH_DOMAIN_CONTACTS`
>
> Search a domain or company for professional contacts, with optional mobile phone enrichment on non-managed calls. Managed calls accept a limit of 10 or no explicit limit; searches with no results are free, and a credit covers up to 10 returned emails.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.017 per successful domain search returning up to 10 emails
>
> **Discount:** 91
>
> #### Input Parameters
>
> **page** `integer`
>
> One-indexed result page. This parameter is available on premium plans.
>
> **limit** `integer ("10" | "20" | "50")`
>
> Maximum emails to return: 10, 20, or 50. This parameter is available on premium plans.
>
> **domain** `string`
>
> Company domain to search, such as stripe.com. Required when company is omitted and preferred when both are supplied.
>
> **company** `string`
>
> Company name to search. Required when domain is omitted.
>
> **country** `string`
>
> Two-letter country code used to filter contacts, such as US.
>
> **department** `string ("engineering" | "sales" | "finance" | "hr" | "it" | "marketing" | "operations" | "management" | "executive" | "legal" | "support" | "communication" | "software" | "security" | "pr" | "warehouse" | "diversity" | "administrative" | "facilities" | "accounting")`
>
> Department used to filter contacts, such as engineering, sales, or marketing.
>
> **enrich\_mobile** `boolean`
>
> Whether to include available mobile phone enrichment for returned contacts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Usage Statistics
>
> **Slug:** `TOMBA_USAGE_STATS`
>
> Tool to get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Phone Number
>
> **Slug:** `TOMBA_VALIDATE_PHONE`
>
> Validate and format a phone number. 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.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.017 per successful phone validation
>
> **Discount:** 91
>
> #### Input Parameters
>
> **phone** `string` *required*
>
> Phone number to validate, preferably in international format.
>
> **country\_code** `string`
>
> Country code used to interpret a national-format phone number, such as US.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Email
>
> **Slug:** `TOMBA_VERIFY_EMAIL`
>
> Verify email deliverability and mailbox signals, optionally requesting an associated mobile phone number on non-managed calls. Charged only when a verification result is returned; no-result verifications are free, account-plan rate limits apply, and on HTTP 429 honor Retry-After before retrying.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.008 per successful verification; no result is free
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to verify.
>
> **enrich\_mobile** `boolean`
>
> Set true to request an associated mobile phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Emails
>
> **Slug:** `TOMBA_VERIFY_EMAILS`
>
> Verify up to 1000 emails by managing Tomba's asynchronous bulk job synchronously, with per-email charges and account-plan rate limits. The action attempts to delete temporary jobs, but cleanup can fail and the workflow is not atomic.
>
> #### Input Parameters
>
> **emails** `array` *required*
>
> Email addresses to verify in one temporary bulk job.
>
> **timeout\_seconds** `integer`
>
> Polling window in seconds for the bulk job to complete. In-flight create, launch, download, and cleanup requests may extend the total action duration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
