Copy page

Integrations

n8n Integration

Overview

Tomba is a verified n8n community node providing 30+ operations across 13 resources for email discovery, verification, enrichment, phone lookup, company search, and lead management. Supports both API Key and OAuth2 authentication.

Installation

From n8n (Recommended)

Via Community Nodes

1. Go to Settings → Community Nodes
2. Enter n8n-nodes-tomba
3. Click Install

Or via npm:

Code
npm install n8n-nodes-tomba

Authentication

The Tomba node supports two authentication methods:

Method	Setup
API Key (default)	Enter your API Key and Secret from app.tomba.io/api
OAuth2	Connect via OAuth2 flow — recommended for shared workflows

Resources & Operations

Domain (6 operations)

Operation	Description	Input
Domain Search	Find all emails for a domain	domain or company
Domain Status	Check if webmail or disposable	domain
Autocomplete	Company name suggestions	query
Location	Employee locations by country	domain
Similar	Find similar domains	domain
Technology	Detect tech stack	domain

Email (6 operations)

Operation	Description	Input
Email Finder	Find email by name + domain	domain, firstName, lastName
Email Verifier	Verify email deliverability	email
Email Enrichment	Person + company data from email	email
Email Count	Total emails for a domain	domain
Email Sources	Where an email was found online	email
Email Format	Format patterns for a domain	domain

Finder (2 operations)

Operation	Description	Input
Author Finder	Find email from a blog post URL	url
LinkedIn Finder	Find email from a LinkedIn URL	url

Phone (2 operations)

Operation	Description	Input
Phone Finder	Find phone by email, domain, or LinkedIn	email / domain / linkedin
Phone Validator	Validate a phone number	phone

Company (1 operation)

Operation	Description	Input
Search Companies	AI-powered company search	query or structured filters

Enrichment (3 operations)

Operation	Description	Input
Person	Person enrichment by email	email
Company	Company enrichment by domain	domain
Combined	Person + company by email	email

Lead (5 operations)

Operation	Description	Input
List	List all leads	page, limit, domain (optional)
Get	Get a lead by ID	leadId
Create	Create a new lead	email, listId
Update	Update a lead	leadId, fields
Delete	Delete a lead	leadId

Lead List (5 operations)

Operation	Description	Input
List	List all lead lists	—
Get	Get a list by ID	listId
Create	Create a new list	name
Update	Update a list	listId, name
Delete	Delete a list	listId

Lead Attribute (5 operations)

Operation	Description	Input
List	List all attributes	—
Get	Get an attribute by ID	attributeId
Create	Create an attribute	name, type
Update	Update an attribute	attributeId, fields
Delete	Delete an attribute	attributeId

Key (5 operations)

Operation	Description	Input
List	List all API keys	—
Get	Get a key by ID	keyId
Create	Create a new API key	—
Reset	Reset (regenerate) a key	keyId
Delete	Delete an API key	keyId

Account (3 operations)

Operation	Description	Input
Account	Get account information	—
Usage	Get API usage statistics	—
Logs	Get API request logs	—

Flag (2 operations)

Operation	Description	Input
List	List submitted flags	page, limit
Create	Report incorrect data	flagType, value, reason

Flag type/reason validation:

Flag Type	Valid Reasons
email	hard_bounce, invalid_email, wrong_person, outdated, other
organization	wrong_company, outdated, other
phone	wrong_phone, outdated, other
author_url	broken_url, wrong_person, outdated, other
website	broken_url, wrong_company, outdated, other

Custom API Call (1 operation)

Operation	Description	Input
Custom API Call	Make any authenticated request to the Tomba API	method, endpoint, query params, body, headers

Use this to call any Tomba API endpoint not covered by the built-in operations. Authentication is handled automatically.

Workflow Examples

Lead Generation

Code
[Webhook] → [Tomba: Domain Search] → [Tomba: Email Verifier] → [Filter: Deliverable Only] → [CRM: Create Contact]

Email Validation Pipeline

Code
[CSV Import] → [Tomba: Email Verifier] → [IF: Score > 90] → [Google Sheets: Add Row]

LinkedIn Prospecting

Code
[Spreadsheet: LinkedIn URLs] → [Tomba: LinkedIn Finder] → [Tomba: Phone Finder] → [Tomba: Create Lead] → [Slack: Notify]

Company Research

Code
[Trigger] → [Tomba: Search Companies (query: "SaaS in France")] → [Tomba: Technology] → [Tomba: Domain Search] → [Airtable: Create Record]

Hard Bounce Recovery

Code
[Email Campaign: Bounce Event] → [Tomba: Create Flag (email, hard_bounce)] → [CRM: Tag Contact]

Lead Management

Code
[Form Submission] → [Tomba: Create Lead List] → [Tomba: Create Lead] → [Tomba: Email Verifier] → [Tomba: Update Lead (score)]

Rate Limits

Rate limits are enforced per endpoint and per plan across three dimensions: per-second (rps), per-minute (rpm), and daily. Your daily limit equals monthly_credits / 5.

Plan	Credits/mo	Per Second	Per Minute	Per Day
Free	25	1	2	5
Basic	2,500	3	50	500
Growth	5,000	5	80	1,000
Pro	20,000	8	150	4,000
Pay-as-you-go 20k	20,000	10	200	4,000
50,000+ plans	50,000+	Unlimited	Unlimited	Unlimited

Request Costs

Operation	Cost	Quota Source
Domain Search	1 credit per 10 emails	Searches
Email Finder	1 credit per email	Searches
Author Finder	1 credit per email	Searches
Email Enrichment	1 credit per email	Searches
LinkedIn Finder	1 credit per email	Searches
Email Verifier	1 credit per email	Verifications
Phone Finder	5 credits per 10 phones	Searches
Phone Validator	1 credit per phone	Searches
Reveal (Companies Search)	1 credit per 50 companies	Searches
Email Count	1 credit per domain	Email Count
Email Sources	1 credit per email	Sources

No credits are charged when Tomba cannot provide a result. Duplicate requests within 30 days are not counted again.

Handling Rate Limits in n8n

The Tomba node returns rate limit headers on every response. When you hit a 429 Too Many Requests:

• n8n's built-in retry mechanism will handle retries automatically if Retry On Fail is enabled on the node
• Configure Wait Between Tries to respect the Retry-After header
• Use the Wait node between multiple Tomba nodes to space out requests
• Monitor usage at app.tomba.io/usage
• Upgrade your plan for higher limits — 50k+ plans have no rate limits

Performance

Recommended timeout: 120 seconds. Tomba searches run in real time against live infrastructure — response times vary with the target company's SMTP server speed, website responsiveness, and the depth of catch-all detection.

To configure timeout in n8n:

1. Select the Tomba node
2. Go to Settings → Timeout
3. Set to 120 seconds (or higher for Domain Search on large domains)

Best Practices

• Set generous timeouts — some SMTP verifications take 30-60 seconds depending on the target mail server
• Use asynchronous calls — pass the webhook_url parameter (available on Domain Search, Email Finder, Email Verifier, Author Finder, LinkedIn Finder, Phone Finder) to receive results via webhook instead of waiting synchronously
• Use bulk endpoints for high-volume workflows — the Tomba API supports bulk operations for all major endpoints (up to 25,000 items per batch)
• Enable Retry On Fail on the Tomba node with exponential backoff to handle transient errors and rate limits gracefully
• Split large lists — process items in batches using n8n's SplitInBatches node with a Wait node between batches

Compatibility

• n8n version 1.113.3 and above
• Node.js 18+

Resources

• Tomba on n8n Integrations
• GitHub: n8n-nodes-tomba
• Tomba API Documentation
• Rate Limits
• Tomba Support