# Integrate Tomba Finder with n8n

## Installation

Tomba is a verified n8n node, which means it's been reviewed and approved by n8n for security and quality.

### Install from n8n Integrations (Recommended)

The easiest way to install Tomba is directly from the [n8n Tomba integration page](https://n8n.io/integrations/tomba/):

<Stepper>

1. **Sign in to n8n**

    [Sign in to n8n](https://app.n8n.cloud/register), open the editor, and click **+** in the top right to open the Nodes panel.

2. **Search for Tomba**

    Type "Tomba" in the search field to find the node.

3. **Add to Workflow**

    Click on the Tomba node to add it to your workflow.

</Stepper>

Learn more about [using verified nodes in n8n](https://docs.n8n.io/integrations/community-nodes/installation/verified-install/).

### Install via Community Nodes

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

### Installation Steps:

1. Go to **Settings**
2. Click on **"Community Nodes"**
3. Enter `n8n-nodes-tomba` into the text box
4. Click on **"I understand the risk..."**
5. Click on **"Install"**

Alternatively, you can it via npm in your n8n installation:
install

```bash
npm install n8n-nodes-tomba
```

## Operations

The Tomba node supports the following operations:

### [Author Finder](/api/finder#author-finder)

Generate or retrieve the most likely email address from a blog post URL

### [Autocomplete](/api/domain-suggestions#get-domain-suggestions)

Find company names and retrieve logo and domain information

### [Domain Search](/api/finder#domain-search)

Get every email address found on the internet using a given domain name, with sources

### [Domain Status](/api/~endpoints#domain-status)

Find domain status if is webmail or disposable

### [Email Count](/api/finder#email-count)

Find total email addresses we have for one domain

### [Email Enrichment](/api/finder#email-enrichment)

Look up person and company data based on an email

### [Email Finder](/api/finder#email-finder)

Generate or retrieve the most likely email address from a domain name, a first name and a last name

### [Email Format](/api/finder#email-format)

Retrieve the email format patterns used by a specific domain

### [Email Sources](/api/~endpoints#email-sources)

Find email address source somewhere on the web

### [Email Verifier](/api/verifier#email-verifier)

Verify the deliverability of an email address

### [LinkedIn Finder](/api/finder#linkedin-finder)

Generate or retrieve the most likely email address from a LinkedIn URL

### [Location](/api/finder#location)

Get employees location based on the domain name

### [Phone Finder](/api/phone#phone-finder)

Search for phone numbers based on an email, domain, or LinkedIn URL

### [Phone Validator](/api/phone#phone-validator)

Validate a phone number and retrieve its associated information

### [Similar](/api/~endpoints#similar)

Retrieve similar domains based on a specific domain

### [Technology](/api/~endpoints#technology)

Retrieve the technologies used by a specific domain and improve description

## Credentials

To use this node, you need to configure your Tomba API credentials:

1. Sign up for a [Tomba.io account](https://tomba.io/register)
2. Get your API key from the [Tomba dashboard](https://app.tomba.io/api)
3. In n8n, create new credentials for "Tomba API"
4. Enter your API key and secret key

### Required Credential Fields:

- **API Key**: Your Tomba API key
- **API Secret**: Your Tomba API secret

## Compatibility

This node is compatible with n8n version **1.113.3** and above.

## Usage

### Basic Examples

#### Example 1: Email Verification

This workflow verifies the deliverability of an email address using Tomba:

1. **Start Node**: Triggers the workflow
2. **Tomba Node**:
    - Operation: `Email Verifier`
    - Email: `example@domain.com`

#### Example 2: Domain Email Search

Find all email addresses for a domain:

1. **Start Node**: Triggers the workflow
2. **Tomba Node**:
    - Operation: `Domain Search`
    - Domain: `company.com`

### Workflow Examples

#### Lead Generation Workflow

```
[Webhook] → [Tomba Domain Search] → [Filter Valid Emails] → [CRM Integration]
```

#### Email Validation Pipeline

```
[CSV Import] → [Tomba Email Verifier] → [Sort Results] → [Export Valid Emails]
```

#### Company Research Automation

```
[Company List] → [Tomba Company Finder] → [Email Search] → [Contact Database]
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

### How to Contribute

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

### Development Guidelines

- Follow the existing code style
- Add tests for new features
- Update documentation as needed
- Ensure all tests pass before submitting

## Version History

Refer to the [releases page](https://github.com/tomba-io/n8n-nodes-tomba/releases) for detailed version history and changelog.

---

## Support

For support with this community node:

1. Check the [Issues](https://github.com/tomba-io/n8n-nodes-tomba/issues) page
2. Create a new issue if your problem isn't already reported
3. For Tomba API-related issues, contact [Tomba Support](https://app.tomba.io/contact)