Overview
The Icypeas node for n8n enables users to perform both single and bulk email-related searches using the Icypeas API. It supports verifying if an email address exists, searching for a prospect's email based on their name and domain, and discovering all generic email addresses associated with a domain or company. This node is useful in scenarios such as lead generation, contact verification, and enriching CRM data.
Practical examples:
- Verifying a single email address before sending outreach emails.
- Bulk-verifying a list of emails from a spreadsheet.
- Finding possible email addresses for a person at a specific company.
- Discovering generic contact emails (like info@, support@) for a given domain.
Properties
Name | Meaning |
---|---|
Search Type | Select whether to perform a "Single Search" (one email/person/domain) or "Bulk Search" (multiple entries). Options: Single Search, Bulk Search |
Task (Single) | The type of single search to perform. Options: Email Verification (verify one email), Email Search (find email by name & domain), Domain Search (find all generics for a domain/company) |
The email address to verify (used when Task is "Email Verification"). | |
First Name | The first name of the person to search for (used when Task is "Email Search"). |
Last Name | The last name of the person to search for (used when Task is "Email Search"). |
Domain Name | The domain or company name to use for the search (used when Task is "Email Search" or "Domain Search"). |
Task (Bulk) | The type of bulk search to perform. Options: Email Verification, Email Search, Domain Search |
Name | The name for your bulk search task (used in bulk mode). |
Rename Columns | Allows you to map input column names to expected fields ("firstname", "lastname", "domainOrCompany", "email") if your input data uses different headers. |
Output
- For single searches, the output is a JSON object containing the result of the requested operation (e.g., verification status, found email, or list of generic emails).
- For bulk searches, the output is a JSON object summarizing the results for each entry in the batch (e.g., verification statuses, found emails, etc.).
- The node does not output binary data; all outputs are in JSON format.
Dependencies
- External Service: Requires access to the Icypeas API.
- API Credentials: You must provide
apiKey
andapiSecret
in the node credentials. For bulk operations,userId
is also required. - n8n Configuration: No special configuration beyond standard credential setup.
Troubleshooting
Common Issues:
- Missing Credentials: If
apiKey
,apiSecret
, or (for bulk)userId
are not provided, the node will throw a "Credentials are missing." error. - Unauthorized Access: If the credentials are invalid, you'll see "Unauthorized access."
- Input Mapping Errors: For bulk operations, ensure your input data columns match the expected field names or use the "Rename Columns" property to map them correctly.
- Unknown Errors: Any other unexpected issues will result in "An unknown error occurred while processing the request."
How to resolve:
- Double-check that all required credentials are entered correctly.
- For bulk operations, make sure your credentials include a valid
userId
. - Ensure your input data structure matches what the node expects, especially when using bulk mode.
Links and References
- Icypeas Website
- n8n Documentation
- For API details, refer to Icypeas' official documentation or support.