Skip to main content
Tomba logo
  • 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

Slug: TOMBA_ATTRIBUTES_LISTRetrieves 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_DOMAIN_STATUSTool 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

string
required
The domain name to check the status for (e.g., ‘gmail.com’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_ENRICH_COMPANYEnrich 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

string
required
Company domain to enrich, without a URL path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_ENRICH_PERSONEnrich 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 enrichmentDiscount: 91

Input Parameters

string
required
Professional email address of the person to enrich.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_ENRICH_PERSON_AND_COMPANYEnrich 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

string
required
Professional email address used to enrich both person and company.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_FIND_AUTHORFind 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 findDiscount: 91

Input Parameters

string
required
Public article URL whose author should be identified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_FIND_EMAILFind 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 findDiscount: 91

Input Parameters

string
Company domain, such as stripe.com. Either domain or company is required; domain takes precedence when both are provided.
string
Company name. Either company or domain is required.
string
Person’s full name. Provide this or both first_name and last_name.
string
Person’s last name. Required with first_name when full_name is omitted.
string
Person’s first name. Required with last_name when full_name is omitted.
boolean
Set true to request an associated mobile phone number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_FIND_EMAIL_FROM_LINKEDINFind 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 findDiscount: 91

Input Parameters

string
required
Full LinkedIn profile URL.
boolean
Set true to return all emails associated with the LinkedIn profile instead of only the most likely email.
boolean
Set true to request associated mobile phone data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_FIND_PHONEFind 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 phonesDiscount: 91

Input Parameters

boolean
Whether to return all associated phone numbers instead of only the primary result.
string
Email address to search. At least one of email, domain, or linkedin is required.
string
Company domain to search. At least one of email, domain, or linkedin is required.
string
LinkedIn profile URL to search. At least one of email, domain, or linkedin is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_GET_EMAIL_COUNTReturn 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

string
required
Domain whose available professional email counts should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_GET_EMAIL_FORMATReturn 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

string
required
Domain whose detected professional email patterns should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_GET_EMAIL_SOURCESReturn 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

string
required
Email address whose public web sources should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_GET_EMPLOYEE_LOCATIONSReturn 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

string
required
Domain whose employee distribution by country should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_KEYS_DELETETool 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_KEYS_LISTTool to list all API keys. Use when you want to retrieve information about your existing Tomba API keys.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_LEADS_CREATECreate 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

string
City where the lead is located
array
List of tags to categorize or label the lead for organization
string
required
Lead’s email address (required). Must be a valid email format
string
Lead’s phone number, including country code if international
string
State or province where the lead is located
string
Company or organization the lead works for
string
Two-letter ISO 3166-1 alpha-2 country code. Must use the code format, not full country name
string
Full Twitter/X profile URL
string
Lead’s personal or company website URL
string
Full LinkedIn profile URL
string
Lead’s job title or position
string
Lead’s last name. If provided, must not be empty
string
required
Lead’s first name (required)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_LEADS_LISTTool to list all leads. Use when you need to retrieve and paginate your leads list.

Input Parameters

integer
Page number to retrieve (1-indexed). Defaults to 1 if not specified.
integer
Number of leads per page (1-100). Defaults to 10 if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_LISTS_DELETETool to delete a leads list by ID. Use when you need to permanently remove a list after confirming its ID.

Input Parameters

string
required
The unique numeric identifier of the leads list to delete. Obtain this ID from the lists list action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_LISTS_LISTList 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

integer
Page number for pagination, must be >= 1
integer
Number of items per page, between 1 and 100

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_LISTS_UPDATETool to update a leads list’s name by ID. Use when renaming an existing list after obtaining its ID.

Input Parameters

string
required
Numeric ID of the leads list to update (obtain from TOMBA_LISTS_LIST action)
string
required
New name for the leads list. Must be unique across all lists in the account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_SEARCH_DOMAIN_CONTACTSSearch 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 emailsDiscount: 91

Input Parameters

integer
One-indexed result page. This parameter is available on premium plans.
integer ("10" | "20" | "50")
Maximum emails to return: 10, 20, or 50. This parameter is available on premium plans.
string
Company domain to search, such as stripe.com. Required when company is omitted and preferred when both are supplied.
string
Company name to search. Required when domain is omitted.
string
Two-letter country code used to filter contacts, such as US.
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.
boolean
Whether to include available mobile phone enrichment for returned contacts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_USAGE_STATSTool to get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_VALIDATE_PHONEValidate 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 validationDiscount: 91

Input Parameters

string
required
Phone number to validate, preferably in international format.
string
Country code used to interpret a national-format phone number, such as US.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_VERIFY_EMAILVerify 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

string
required
Email address to verify.
boolean
Set true to request an associated mobile phone number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOMBA_VERIFY_EMAILSVerify 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

array
required
Email addresses to verify in one temporary bulk job.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not