Single Email Verification using Icypeas API - n8n Workflow

Use this efficient n8n workflow to verify single email addresses via the Icypeas API. Configure the custom n8n node to handle API authentication, signing, and HTTP requests easily.

Workflow Preview

Ready to automate?

Download this n8n workflow template and start using it instantly.

Who is this best for?

Lead generation specialists requiring high data quality.
Marketing teams focused on reducing bounce rates.
Users looking for advanced custom API authentication methods within n8n.
Developers needing reliable email verification services integrated into their n8n workflow.

Overview

This robust n8n workflow solves the challenge of generating the complex API signatures required by services like Icypeas. Instead of relying on external tools or complex server setup, this n8n template uses a specialized Code n8n node to dynamically generate the necessary cryptographic signature (SHA1) based on your API secret, timestamp, and request path. Once authenticated, the n8n workflow uses an HTTP Request n8n node to send the target email address for verification. Implementing this specific n8n workflow provides a streamlined, technical solution for crucial data verification tasks, helping maintain clean and accurate contact lists. This efficient use of core n8n functionality showcases powerful automation potential.

How it Works


  1. Manual Start: The process initiates using the Manual n8n trigger ("When clicking 'Execute Workflow'"), allowing users to run the n8n workflow on demand for testing or single-instance use.

  2. Authentication Setup: The custom Code n8n node ("Authenticates to your Icypeas account") requires the user to input their Icypeas API Key, API Secret, and User ID. This key n8n node then utilizes the built-in crypto module to calculate a unique SHA1 signature based on the request parameters. All necessary API data (timestamp, signature, key) is prepared and passed forward within the n8n workflow data structure.

  3. API Request: The HTTP Request n8n node ("Run email verification (single)") executes a highly customized POST request to the Icypeas verification endpoint.

  4. Header Authorization: This n8n node is configured to use the dynamically generated API Key and Signature within the Authorization header, successfully authenticating the request using the parameters derived from the previous n8n node.

  5. Email Verification: The n8n node sends the target email address in the request body, and the n8n workflow captures the verification result from Icypeas.

Installation Guide


  1. Import: Copy the provided JSON and import it directly into your n8n instance as a new n8n workflow.

  2. Code Node Configuration: Open the Code n8n node named "Authenticates to your Icypeas account." Replace the placeholders (e.g., PUTAPIKEY_HERE) with your actual Icypeas credentials found on your profile.

  3. Self-Hosted Requirement: If you are running a self-hosted n8n instance, you must enable the crypto module in the n8n General Settings for the signature generation code within the n8n node to function.

  4. Credential Setup (HTTP Request n8n node):

Open the "Run email verification (single)" HTTP Request n8n node.
In the Credential for Header Auth section, click 'Create new Credential'.
Name the credential "Authorization."
Set the Value field as an expression: {{ $json.api.key + ':' + $json.api.signature }}. Save the credential.

  1. Email Input: In the same HTTP Request n8n node, modify the Body Parameters section to input the specific email address you wish to verify. This completes the setup for the n8n workflow.

  2. Activation: Save and execute the n8n workflow manually using the n8n trigger to confirm the integration.

Node Details

When clicking "Execute Workflow" (Manual n8n Trigger): The starting n8n trigger for this n8n workflow, allowing immediate execution for development and testing of the n8n templates.
Authenticates to your Icypeas account (Code n8n node):
Function: Generates a required SHA1 signature and prepares necessary API variables (timestamp, URL, signature) using custom JavaScript, enabling secure requests from the n8n workflow.
Key Configuration: Requires manual input of APIKEY, APISECRET, and USER_ID. Crucial for dynamic header generation in the next n8n node.
Run email verification (single) (HTTP Request n8n node):
Function: Executes the core verification task by sending a POST request to the Icypeas API.
Key Configuration:
URL: Uses an expression ({{ $json.api.url }}) passed from the previous n8n node.
Authentication: Uses a custom Header Auth credential configured with a complex expression to merge the API Key and generated Signature.
Headers: Includes the dynamic X-ROCK-TIMESTAMP header required for request verification.

Related n8n Workflows

Free

Nodes: 4 Nodes
Updated: December 26 2025
View all
Created by
Corentin Ribeyre
Corentin Ribeyre

Featured*