Icypeas icon

Icypeas

Icypeas Node for n8n will take care of the single and bulk searches (verify emails, search for emails, discover all generic emails from a domain)

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)
Email 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 and apiSecret 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

Discussion