Tomba icon

Tomba

Consume Tomba API

Overview

The Tomba node's "Domain Search" operation allows you to find all email addresses associated with a given domain by searching public sources on the internet. This is useful for lead generation, sales prospecting, or verifying company contact information. For example, you can input "stripe.com" and retrieve a list of emails found for that domain, optionally filtering by type (personal/generic) or department.

Practical scenarios:

  • Building a list of potential contacts at a target company.
  • Enriching CRM data with verified email addresses from a company's domain.
  • Filtering results to only include specific departments, such as Sales or Marketing.

Properties

Name Meaning
Domain Domain name from which you want to find the email addresses. For example, "stripe.com".
Only Emails Whether to return only the found emails (true/false). If enabled, the output will be a flat list of emails instead of the full API response structure.
Limit Max number of results to return. Must be at least 1.
Filters Additional filters to refine your search. Includes:
- Type: Personal, Generic
- Department: Communication, Executive, Finance, HR, IT, Legal, Management, Marketing, Sales, Support

Output

  • If Only Emails is enabled:
    The output is an array of email objects, each typically containing fields like email, first_name, last_name, position, etc.

  • If Only Emails is disabled:
    The output is the full response object from Tomba, which includes:

    • emails: Array of email objects (as above)
    • domain: The queried domain
    • organization: Information about the organization
    • meta: Metadata about the query (e.g., total results, pagination info)
    • Other possible fields depending on the API response

Example output (Only Emails = true):

[
  {
    "email": "john.doe@stripe.com",
    "first_name": "John",
    "last_name": "Doe",
    "position": "Engineer"
  },
  {
    "email": "jane.smith@stripe.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "position": "Manager"
  }
]

Example output (Only Emails = false):

{
  "domain": "stripe.com",
  "organization": { "name": "Stripe", ... },
  "emails": [
    {
      "email": "john.doe@stripe.com",
      "first_name": "John",
      "last_name": "Doe",
      "position": "Engineer"
    }
  ],
  "meta": { "total": 2, ... }
}

Dependencies

  • External Service: Requires access to the Tomba API.
  • API Key: You must configure Tomba API credentials in n8n under the name tombaApi.
  • n8n Configuration: No additional configuration required beyond setting up credentials.

Troubleshooting

  • Missing or Invalid API Key:
    Error: Authentication failed or similar.
    Solution: Ensure your Tomba API credentials are correctly set up in n8n.

  • No Results Found:
    Error: Empty array or no emails returned.
    Solution: Check if the domain is correct and publicly available emails exist for it.

  • Invalid Domain Format:
    Error: API may return validation errors if the domain is malformed.
    Solution: Enter a valid domain name (e.g., "stripe.com").

  • Limit Exceeded:
    Error: May receive fewer results than requested if not enough emails are found.
    Solution: Lower the limit or try a different domain.

  • Filter Mismatch:
    Error: No emails match the selected filters (type/department).
    Solution: Adjust or remove filters to broaden the search.

Links and References

Discussion