Skip to main content
Questa guida ti mostra come collegare l’API Enrow a n8n e creare il tuo primo workflow: una ricerca di una singola email che restituisce automaticamente il proprio risultato tramite un webhook. n8n è uno strumento di automazione dei workflow che ti permette di connettere Enrow con centinaia di altri servizi, e può essere self-hosted o eseguito su n8n Cloud.
Non hai n8n? Installa n8n o usa n8n Cloud per iniziare in pochi minuti.

Di cosa ho bisogno prima di iniziare?

Per seguire questa guida ti servono due cose: Ogni richiesta a Enrow viene autenticata con la chiave API nell’header x-api-key — non ci sono flussi OAuth né bearer token. Per tutti i dettagli, consulta Authentication.

Come memorizzo la mia chiave API Enrow in n8n?

Memorizza la chiave API una sola volta come credenziale riutilizzabile Header Auth, così non dovrai incollarla in ogni nodo:
  1. In n8n, apri CredentialsNew
  2. Scegli Header Auth
  3. Imposta Name su x-api-key
  4. Imposta Value sulla tua chiave API Enrow
  5. Salva la credenziale (ad esempio, chiamala “Enrow API”)
Ora puoi fare riferimento a questa credenziale da qualsiasi nodo HTTP Request nei tuoi workflow.

Come creo un workflow che trova una singola email?

Il workflow è composto da tre parti: un trigger per avviarlo, un nodo HTTP Request che chiama l’endpoint Find Single Email e un nodo Webhook che riceve il risultato al completamento della ricerca.

Step 1: Crea un nuovo workflow

  1. Apri n8n
  2. Clicca su “New Workflow”
  3. Chiamalo “Enrow - Find Email”

Step 2: Aggiungi un Manual Trigger

  1. Clicca sul pulsante ”+”
  2. Cerca “Manual Trigger”
  3. Aggiungilo al tuo canvas
Il Manual Trigger ti permette di eseguire il workflow su richiesta mentre lo testi.

Step 3: Aggiungi un nodo HTTP Request

  1. Clicca su ”+” dopo il Manual Trigger
  2. Cerca “HTTP Request”
  3. Configuralo:
Authentication:
  • Authentication: Generic Credential Type
  • Generic Auth Type: Header Auth
  • Name: x-api-key
  • Value: YOUR_ENROW_API_KEY
Request:
  • Method: POST
  • URL: https://api.enrow.io/email/find/single
  • Body Content Type: JSON
  • JSON Body:
{
  "company_domain": "apple.com",
  "fullname": "Tim Cook"
}

Step 4: Testa il workflow

  1. Clicca su “Execute Workflow” in alto
  2. Dovresti vedere una risposta con un id della ricerca
  3. La ricerca viene elaborata in modo asincrono — l’id è ciò che userai per recuperare il risultato

Step 5: Ricevi i risultati con un webhook

Enrow esegue le ricerche in modo asincrono, quindi invece di effettuare il polling, lascia che sia n8n a ricevere automaticamente il risultato. L’API Enrow invierà il risultato in POST all’URL del tuo webhook non appena la ricerca termina. Consulta How webhooks work per il flusso completo.
  1. Aggiungi un nodo “Webhook” al tuo canvas
  2. Imposta:
    • HTTP Method: POST
    • Path: enrow-email-result
  3. Copia il Production URL (es. https://your-n8n.com/webhook/enrow-email-result)
  4. Aggiorna il JSON del tuo nodo HTTP Request per includere il webhook in settings:
{
  "company_domain": "apple.com",
  "fullname": "Tim Cook",
  "settings": {
    "webhook": "https://your-n8n.com/webhook/enrow-email-result"
  }
}
  1. Salva e attiva il workflow
Ora, quando la ricerca verrà completata, Enrow invierà il risultato in POST al tuo nodo webhook.

Posso importare un workflow già pronto?

Sì. Copia il JSON qui sotto per iniziare rapidamente, poi importalo in n8n.
{
  "name": "Enrow - Find Email with Webhook",
  "nodes": [
    {
      "parameters": {},
      "name": "Manual Trigger",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [250, 300]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.enrow.io/email/find/single",
        "authentication": "headerAuth",
        "sendBody": true,
        "bodyContentType": "json",
        "jsonBody": "={\n  \"company_domain\": \"apple.com\",\n  \"fullname\": \"Tim Cook\",\n  \"settings\": {\n    \"webhook\": \"{{$node[\"Webhook\"].json[\"webhookUrl\"]}}\"\n  }\n}",
        "options": {}
      },
      "name": "Find Email",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 3,
      "position": [450, 300],
      "credentials": {
        "headerAuth": {
          "name": "Enrow API"
        }
      }
    },
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "enrow-email-result",
        "responseMode": "onReceived",
        "options": {}
      },
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [650, 300],
      "webhookId": "your-webhook-id"
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [[{"node": "Find Email", "type": "main", "index": 0}]]
    },
    "Find Email": {
      "main": [[{"node": "Process Result", "type": "main", "index": 0}]]
    }
  }
}
Per importare il workflow:
  1. Copia il JSON qui sopra
  2. In n8n, clicca su ”…”“Import from File/URL/String”
  3. Incolla il JSON
  4. Aggiorna la chiave API nelle credenziali
  5. Attiva!

Quali sono le best practice per n8n + Enrow?

Crea una credenziale Header Auth con:
  • Name: x-api-key
  • Value: La tua chiave API Enrow
Riutilizza questa credenziale tra i workflow invece di incollare la chiave API in ogni nodo.
I webhook sono più affidabili del polling con i nodi Wait. Passa sempre il parametro settings.webhook così che Enrow consegni il risultato non appena la ricerca è completata.
Aggiungi un nodo “Error Trigger” per intercettare e gestire gli errori dell’API. Consulta Error handling e Status codes per i formati delle risposte da aspettarti.
Se stai elaborando molti contatti, usa l’endpoint Find Bulk Emails (fino a 5.000 ricerche per batch) invece di iterare richieste singole.

FAQ

Un 401 Unauthorized significa che la chiave API è mancante o non valida. Verifica che la credenziale Header Auth abbia x-api-key come Name e la tua chiave API Enrow valida come Value. Consulta Authentication per i dettagli.
Innanzitutto, assicurati che il workflow sia attivato, non solo salvato. Poi verifica che l’URL del webhook nel parametro settings.webhook corrisponda al Production URL del nodo Webhook. Puoi testare l’URL direttamente con uno strumento come Postman. Consulta How webhooks work per il flusso di consegna.
Un errore di rate limit significa che hai inviato troppe richieste troppo rapidamente. Aggiungi un nodo “Wait” tra le operazioni batch, oppure usa gli endpoint bulk invece di iterare. Consulta Rate limits per i limiti attuali.
Per domande sui workflow, usa il n8n Community Forum. Per domande sull’API, contatta il supporto Enrow.

Prossimi passi

Arricchimento email

Arricchisci i contatti da un foglio di calcolo in n8n.

Verifica email

Verifica le liste di email dei lead in un workflow n8n.

Trova email

Consulta i parametri dell’endpoint e il formato della risposta.

Come funzionano i webhook

Ricevi una notifica automatica al completamento di una ricerca.