> ## 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 en n8n

> Conecta la API de Enrow a n8n con Header Auth y crea tu primer flujo de búsqueda de emails con webhooks

Esta guía te muestra cómo conectar la API de Enrow a n8n y crear tu primer flujo de trabajo: una búsqueda de un solo email que devuelve su resultado automáticamente a través de un webhook. n8n es una herramienta de automatización de flujos de trabajo que te permite conectar Enrow con cientos de otros servicios, y puede ser autoalojada o ejecutarse en n8n Cloud.

<Note>
  **¿No tienes n8n?** [Instala n8n](https://docs.n8n.io/hosting/) o usa [n8n Cloud](https://n8n.io/cloud/) para empezar en cuestión de minutos.
</Note>

## ¿Qué necesito antes de empezar?

Para seguir esta guía necesitas dos cosas:

* n8n instalado (autoalojado o en la nube)
* Una clave de API de Enrow ([consíguela aquí](https://app.enrow.io/settings/api-keys))

Cada solicitud de Enrow se autentica con la clave de API en el encabezado `x-api-key`: no hay flujos de OAuth ni tokens bearer. Para más detalles, consulta [Authentication](/es/authentication).

## ¿Cómo guardo mi clave de API de Enrow en n8n?

Guarda la clave de API una sola vez como una credencial **Header Auth** reutilizable para no tener que pegarla en cada nodo:

1. En n8n, abre **Credentials** → **New**
2. Elige **Header Auth**
3. Establece **Name** en `x-api-key`
4. Establece **Value** en tu clave de API de Enrow
5. Guarda la credencial (por ejemplo, nómbrala "Enrow API")

Ahora puedes referenciar esta credencial desde cualquier nodo HTTP Request en todos tus flujos de trabajo.

## ¿Cómo creo un flujo de trabajo que encuentra un solo email?

El flujo de trabajo tiene tres partes: un disparador para iniciarlo, un nodo HTTP Request que llama al endpoint [Find Single Email](/es/api-reference/email-finder/find-single) y un nodo Webhook que recibe el resultado cuando la búsqueda se completa.

### Paso 1: Crea un nuevo flujo de trabajo

1. Abre n8n
2. Haz clic en **"New Workflow"**
3. Nómbralo "Enrow - Find Email"

### Paso 2: Añade un Manual Trigger

1. Haz clic en el botón **"+"**
2. Busca **"Manual Trigger"**
3. Añádelo a tu lienzo

El Manual Trigger te permite ejecutar el flujo de trabajo bajo demanda mientras lo pruebas.

### Paso 3: Añade un nodo HTTP Request

1. Haz clic en **"+"** después del Manual Trigger
2. Busca **"HTTP Request"**
3. Configúralo:

**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"
}
```

### Paso 4: Prueba el flujo de trabajo

1. Haz clic en **"Execute Workflow"** en la parte superior
2. Deberías ver una respuesta con un `id` de búsqueda
3. La búsqueda se procesa de forma asíncrona: el `id` es lo que usarás para recuperar el resultado

### Paso 5: Recibe los resultados con un webhook

Enrow ejecuta las búsquedas de forma asíncrona, así que en lugar de hacer sondeos, deja que n8n reciba el resultado automáticamente. La API de Enrow hará un POST del resultado a la URL de tu webhook una vez que la búsqueda finalice. Consulta [How webhooks work](/es/how-webhooks-work) para ver el flujo completo.

1. Añade un nodo **"Webhook"** a tu lienzo

2. Establece:
   * HTTP Method: `POST`
   * Path: `enrow-email-result`

3. Copia la **Production URL** (p. ej., `https://your-n8n.com/webhook/enrow-email-result`)

4. Actualiza el JSON de tu nodo HTTP Request para incluir el webhook en `settings`:

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

5. Guarda y activa el flujo de trabajo

Ahora, cuando la búsqueda se complete, Enrow hará un POST del resultado a tu nodo webhook.

## ¿Puedo importar un flujo de trabajo ya hecho?

Sí. Copia el JSON de abajo para empezar rápidamente y luego impórtalo en 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}]]
    }
  }
}
```

Para importar el flujo de trabajo:

1. Copia el JSON de arriba
2. En n8n, haz clic en **"..."** → **"Import from File/URL/String"**
3. Pega el JSON
4. Actualiza la clave de API en las credenciales
5. ¡Actívalo!

## ¿Cuáles son las mejores prácticas para n8n + Enrow?

<AccordionGroup>
  <Accordion title="Guarda la clave de API como una credencial">
    Crea una credencial **Header Auth** con:

    * Name: `x-api-key`
    * Value: Tu clave de API de Enrow

    Reutiliza esta credencial en todos tus flujos de trabajo en lugar de pegar la clave de API en cada nodo.
  </Accordion>

  <Accordion title="Usa webhooks, no nodos Wait">
    Los webhooks son más fiables que el sondeo con nodos Wait. Pasa siempre el parámetro `settings.webhook` para que Enrow entregue el resultado en cuanto la búsqueda se complete.
  </Accordion>

  <Accordion title="Gestiona los errores con elegancia">
    Añade un nodo **"Error Trigger"** para capturar y gestionar los errores de la API. Consulta [Error handling](/es/error-handling) y [Status codes](/es/status-codes) para conocer los formatos de respuesta que puedes esperar.
  </Accordion>

  <Accordion title="Usa endpoints en lote para múltiples búsquedas">
    Si estás procesando muchos contactos, usa el endpoint [Find Bulk Emails](/es/api-reference/email-finder/find-bulk) (hasta 5.000 búsquedas por lote) en lugar de iterar solicitudes individuales.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="¿Por qué obtengo un error Unauthorized?">
    Un `401 Unauthorized` significa que la clave de API falta o no es válida. Verifica que la credencial **Header Auth** tenga `x-api-key` como **Name** y tu clave de API de Enrow válida como **Value**. Consulta [Authentication](/es/authentication) para más detalles.
  </Accordion>

  <Accordion title="¿Por qué mi webhook no recibe datos?">
    Primero, asegúrate de que el flujo de trabajo esté **activado**, no solo guardado. Luego confirma que la URL del webhook en el parámetro `settings.webhook` coincida con la **Production URL** del nodo Webhook. Puedes probar la URL directamente con una herramienta como Postman. Consulta [How webhooks work](/es/how-webhooks-work) para ver el flujo de entrega.
  </Accordion>

  <Accordion title="¿Por qué obtengo un error Rate Limit Exceeded?">
    Un error de límite de tasa significa que enviaste demasiadas solicitudes demasiado rápido. Añade un nodo **"Wait"** entre operaciones por lotes, o usa los endpoints en lote en lugar de iterar. Consulta [Rate limits](/es/rate-limits) para conocer los límites actuales.
  </Accordion>

  <Accordion title="¿Dónde puedo obtener ayuda?">
    Para preguntas sobre flujos de trabajo, usa el [n8n Community Forum](https://community.n8n.io). Para preguntas sobre la API, contacta con [Enrow Support](https://help.enrow.io).
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Enriquecimiento de emails" icon="table" href="/es/playbooks/n8n/email-enrichment-workflow">
    Enriquece contactos desde una hoja de cálculo en n8n.
  </Card>

  <Card title="Verificación de emails" icon="shield-check" href="/es/playbooks/n8n/lead-verification-workflow">
    Verifica listas de emails de leads en un flujo de trabajo de n8n.
  </Card>

  <Card title="Buscar email" icon="envelope" href="/es/api-reference/email-finder/find-single">
    Consulta los parámetros del endpoint y el formato de respuesta.
  </Card>

  <Card title="Cómo funcionan los webhooks" icon="bell" href="/es/how-webhooks-work">
    Recibe una notificación automática cuando una búsqueda se completa.
  </Card>
</CardGroup>