> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrow in n8n

> Collega l'API Enrow a n8n con Header Auth e crea il tuo primo workflow di ricerca email con i webhook

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.

<Note>
  **Non hai n8n?** [Installa n8n](https://docs.n8n.io/hosting/) o usa [n8n Cloud](https://n8n.io/cloud/) per iniziare in pochi minuti.
</Note>

## Di cosa ho bisogno prima di iniziare?

Per seguire questa guida ti servono due cose:

* n8n installato (self-hosted o cloud)
* Una chiave API Enrow ([ottienine una qui](https://app.enrow.io/settings/api-keys))

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](/it/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 **Credentials** → **New**
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](/it/api-reference/email-finder/find-single) 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:

```json theme={null}
{
  "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](/it/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`:

```json theme={null}
{
  "company_domain": "apple.com",
  "fullname": "Tim Cook",
  "settings": {
    "webhook": "https://your-n8n.com/webhook/enrow-email-result"
  }
}
```

5. 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.

```json theme={null}
{
  "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?

<AccordionGroup>
  <Accordion title="Memorizza la chiave API come credenziale">
    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.
  </Accordion>

  <Accordion title="Usa i webhook, non i nodi Wait">
    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.
  </Accordion>

  <Accordion title="Gestisci gli errori con eleganza">
    Aggiungi un nodo **"Error Trigger"** per intercettare e gestire gli errori dell'API. Consulta [Error handling](/it/error-handling) e [Status codes](/it/status-codes) per i formati delle risposte da aspettarti.
  </Accordion>

  <Accordion title="Usa gli endpoint bulk per ricerche multiple">
    Se stai elaborando molti contatti, usa l'endpoint [Find Bulk Emails](/it/api-reference/email-finder/find-bulk) (fino a 5.000 ricerche per batch) invece di iterare richieste singole.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Perché ricevo un errore Unauthorized?">
    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](/it/authentication) per i dettagli.
  </Accordion>

  <Accordion title="Perché il mio webhook non riceve dati?">
    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](/it/how-webhooks-work) per il flusso di consegna.
  </Accordion>

  <Accordion title="Perché ricevo un errore Rate Limit Exceeded?">
    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](/it/rate-limits) per i limiti attuali.
  </Accordion>

  <Accordion title="Dove posso ottenere aiuto?">
    Per domande sui workflow, usa il [n8n Community Forum](https://community.n8n.io). Per domande sull'API, contatta il [supporto Enrow](https://help.enrow.io).
  </Accordion>
</AccordionGroup>

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Arricchimento email" icon="table" href="/it/playbooks/n8n/email-enrichment-workflow">
    Arricchisci i contatti da un foglio di calcolo in n8n.
  </Card>

  <Card title="Verifica email" icon="shield-check" href="/it/playbooks/n8n/lead-verification-workflow">
    Verifica le liste di email dei lead in un workflow n8n.
  </Card>

  <Card title="Trova email" icon="envelope" href="/it/api-reference/email-finder/find-single">
    Consulta i parametri dell'endpoint e il formato della risposta.
  </Card>

  <Card title="Come funzionano i webhook" icon="bell" href="/it/how-webhooks-work">
    Ricevi una notifica automatica al completamento di una ricerca.
  </Card>
</CardGroup>