# Zapier Integration

## Overview

Connect Tomba.io with 5,000+ apps through Zapier to automate your email finding, verification, and enrichment workflows. No coding required.

## Prerequisites

- Active Tomba.io account with API credentials
- Zapier account (free or paid)

## Setup & Authentication

### Connecting Tomba.io to Zapier

1. In your Zap, search for **Tomba.io**
2. Select a trigger or action
3. Click **Sign in to Tomba.io**
4. Enter your credentials:
    - **API Key**: Your Tomba.io API key
    - **Secret Key**: Your Tomba.io secret key
5. Click **Yes, Continue**

**Getting Your API Credentials:**

1. Log in to your [Tomba.io dashboard](https://app.tomba.io)
2. Navigate to [API Keys](https://app.tomba.io/api)
3. Copy your API Key and Secret Key

## Available Actions

### Find Email Address

Find a professional email address using a person's name and company domain.

**Input Fields:**

- **Domain** (required) - Company domain (e.g., `tomba.io`)
- **First Name** (required) - Person's first name
- **Last Name** (required) - Person's last name

**Output:**

- Email address
- Score (accuracy confidence)
- Position
- Department
- Sources
- Verification status

**Example Zap:**

```
Trigger: New Lead in Salesforce
↓
Action: Tomba.io - Find Email Address
↓
Action: Send Email via Gmail
```

### Verify Email Address

Verify if an email address is valid and deliverable.

**Input Fields:**

- **Email** (required) - Email address to verify

**Output:**

- Email status (valid/invalid)
- Result (deliverable/undeliverable/risky/unknown)
- Score (0-100)
- SMTP check results
- Accept-all detection
- Free email provider detection
- Disposable email detection

**Example Zap:**

```
Trigger: New Contact in HubSpot
↓
Action: Tomba.io - Verify Email Address
↓
Filter: Only if deliverable
↓
Action: Add to email campaign
```

### Domain Search

Search for all email addresses associated with a domain.

**Input Fields:**

- **Domain** (required) - Company domain
- **Page** (optional) - Page number for pagination (default: 1)
- **Limit** (optional) - Number of results per page (default: 10, max: 100)
- **Department** (optional) - Filter by department

**Output:**

- Array of email addresses
- Full names
- Positions
- Departments
- Social profiles
- Verification status

**Example Zap:**

```
Trigger: Webhook receives company domain
↓
Action: Tomba.io - Domain Search
↓
Action: Create rows in Google Sheets
```

### Email Count

Get the total number of email addresses for a domain.

**Input Fields:**

- **Domain** (required) - Company domain

**Output:**

- Total email count
- Personal emails count
- Generic emails count

### LinkedIn Email Finder

Find email addresses from LinkedIn profile URLs.

**Input Fields:**

- **LinkedIn URL** (required) - LinkedIn profile URL

**Output:**

- Email address
- Full name
- Position
- Company
- Verification status

**Example Zap:**

```
Trigger: New LinkedIn connection
↓
Action: Tomba.io - LinkedIn Email Finder
↓
Action: Add to CRM
```

### Author Finder

Find the author of a webpage by URL.

**Input Fields:**

- **URL** (required) - Webpage URL

**Output:**

- Author name
- Email address
- Social profiles
- Position

### Enrichment

Enrich company or contact data using email or domain.

**Input Fields:**

- **Email** (optional) - Email address to enrich
- **Domain** (optional) - Domain to enrich

**Output:**

- Full profile data
- Company information
- Social profiles
- Technologies used
- Employee count
- Industry

### Phone Finder

Find phone numbers associated with a domain, email, or LinkedIn URL.

**Input Fields:**

- **Domain** (optional) - Company domain
- **Email** (optional) - Email address
- **LinkedIn URL** (optional) - LinkedIn profile URL

**Output:**

- Phone number(s)
- Phone type (mobile/work)
- Country code
- Verified status

### Phone Validator

Validate phone numbers for format and deliverability.

**Input Fields:**

- **Phone Number** (required) - Phone number to validate
- **Country Code** (optional) - ISO country code (e.g., US, FR)

**Output:**

- Valid/invalid status
- Phone type (mobile/landline/voip)
- Carrier information
- Location
- Format (international/national)

### Similar Domains

Find domains similar to a given domain.

**Input Fields:**

- **Domain** (required) - Company domain

**Output:**

- Array of similar domains
- Match scores
- Company names

### Create Lead

Create a new lead in Tomba.io.

**Input Fields:**

- **Email** (required) - Lead's email address
- **First Name** (optional) - Lead's first name
- **Last Name** (optional) - Lead's last name

**Output:**

- Lead ID
- Created timestamp
- Full lead details

## Example Zaps

### Lead Generation Workflow

**Trigger:** New row in Google Sheets

1. **Tomba.io - Find Email Address** (using name + domain from sheet)
2. **Tomba.io - Verify Email Address**
3. **Filter by Zapier:** Only continue if email is deliverable
4. **HubSpot - Create Contact**
5. **Gmail - Send Email**

### Email Validation Workflow

**Trigger:** New signup in your app

1. **Tomba.io - Verify Email Address**
2. **Paths by Zapier:**
    - Path A (Deliverable) → Send welcome email
    - Path B (Risky/Invalid) → Send to manual review queue

### LinkedIn Prospecting

**Trigger:** New LinkedIn connection

1. **LinkedIn - Get Profile Details**
2. **Tomba.io - LinkedIn Email Finder**
3. **Tomba.io - Verify Email Address**
4. **Salesforce - Create Lead**
5. **Slack - Send Notification**

### Domain Research Workflow

**Trigger:** Webhook receives company domain

1. **Tomba.io - Domain Search**
2. **Tomba.io - Email Count**
3. **Tomba.io - Similar Domains**
4. **Tomba.io - Enrichment**
5. **Airtable - Create Records** (comprehensive company report)

## Advanced Features

### Multi-Step Zaps

Combine multiple Tomba.io actions in a single Zap:

```
Trigger: New Lead
↓
Tomba.io: Find Email
↓
Tomba.io: Verify Email
↓
Tomba.io: Enrich Data
↓
Tomba.io: Phone Finder
↓
CRM: Create Full Profile
```

### Filtering & Paths

Use Zapier's Filter and Paths features to create conditional workflows:

```
Tomba.io: Verify Email
↓
Paths:
  Path 1: Score > 90 → Add to Hot Leads
  Path 2: Score 70-90 → Add to Warm Leads
  Path 3: Score < 70 → Discard
```

### Looping with Zapier Tables

Process multiple records:

```
Zapier Tables: New/Updated Records
↓
Tomba.io: Find Email (for each record)
↓
Zapier Tables: Update Record
```

### Error Handling

Configure error notifications:

1. Enable **Error Notifications** in Zap settings
2. Use **Error Handler** step (Zapier Teams plan)
3. Log errors to Google Sheets or Slack

## Troubleshooting

### Authentication Issues

**Problem:** "Authentication failed"

**Solutions:**

- Verify API credentials in [Tomba.io dashboard](https://app.tomba.io/api)
- Ensure API keys have not been regenerated
- Check that your Tomba.io account is active
- Reconnect the Tomba.io account in Zapier

### No Data Returned

**Problem:** Action completes but returns empty data

**Solutions:**

- Check that the input domain/email format is correct
- Verify the email/domain exists in Tomba.io database
- Review [API usage limits](https://app.tomba.io/usage)
- Check Zap execution history for detailed error messages

### Rate Limiting

**Problem:** "429 Too Many Requests" error

**Solutions:**

- Review your [Tomba.io plan limits](https://tomba.io/pricing)
- Add delays between actions using **Delay by Zapier**
- Upgrade your Tomba.io plan for higher limits
- Batch process requests during off-peak hours

### Zap Doesn't Trigger

**Problem:** Zap doesn't run when expected

**Solutions:**

- Tomba.io doesn't provide triggers - use other apps as triggers
- Check that the trigger app is properly configured
- Verify Zap is turned ON
- Review Zap History for skipped or filtered executions

## Best Practices

1. **Verify Before Sending**: Always verify emails before adding to campaigns
2. **Use Filters**: Filter out invalid or risky emails early in your Zap
3. **Batch Processing**: For large datasets, process in batches to avoid rate limits
4. **Error Handling**: Set up error notifications and logging
5. **Test Thoroughly**: Use Zapier's testing feature before activating
6. **Monitor Usage**: Check your Tomba.io API usage regularly
7. **Data Quality**: Clean input data (remove spaces, validate formats) before Tomba.io actions
8. **Paths for Logic**: Use Paths instead of multiple Zaps for conditional logic

## API Limits

Tomba.io API limits vary by plan:

- **Free**: 50 requests/month
- **Starter**: 1,000 requests/month
- **Growth**: 5,000 requests/month
- **Business**: 25,000 requests/month
- **Enterprise**: Custom limits

[View detailed pricing and limits](https://tomba.io/pricing)

## Zapier-Specific Limits

- Free Zapier accounts: 100 tasks/month
- Zapier Starter: 750 tasks/month
- Zapier Professional: 2,000+ tasks/month

Each Tomba.io action counts as one Zapier task.

## Resources

- [Tomba.io API Documentation](https://docs.tomba.io)
- [Zapier Help Center](https://help.zapier.com)
- [Tomba.io + Zapier Integration Page](https://zapier.com/apps/tomba/integrations)
- [API Status](https://status.tomba.io)

## Support

### Tomba.io Support

- Email: [support@tomba.io](mailto:support@tomba.io)
- Dashboard: [app.tomba.io](https://app.tomba.io)

### Zapier Support

- Help Center: [help.zapier.com](https://help.zapier.com)
- Community: [community.zapier.com](https://community.zapier.com)

## FAQs

**Q: Can I use Tomba.io as a trigger in Zapier?**
A: No, Tomba.io only provides actions. Use other apps (webhooks, Google Sheets, etc.) as triggers.

**Q: How many API calls does one Zap execution use?**
A: Each Tomba.io action in a Zap uses one API request. Multiple actions = multiple requests.

**Q: Can I verify email lists in bulk?**
A: Yes, use a Zapier loop with spreadsheet rows or Zapier Tables. Each verification counts as one API request.

**Q: What happens if I exceed my API limit?**
A: Requests will fail with a 429 error. Upgrade your plan or wait until your limit resets.

**Q: Can I customize the data returned?**
A: Use Zapier's Formatter steps to transform Tomba.io output data as needed.

## Version History

**v1.0.0** - Initial Zapier integration release

- 11 core actions covering all major endpoints
- API Key + Secret Key authentication
- Full error handling
- Comprehensive output data mapping