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

> Connectez l'API Enrow à n8n avec Header Auth et créez votre premier workflow de recherche d'e-mails avec des webhooks

Ce guide vous montre comment connecter l'API Enrow à n8n et créer votre premier workflow : une recherche d'e-mail unique qui renvoie automatiquement son résultat via un webhook. n8n est un outil d'automatisation de workflows qui vous permet de connecter Enrow à des centaines d'autres services, et il peut être auto-hébergé ou exécuté sur n8n Cloud.

<Note>
  **Vous n'avez pas n8n ?** [Installez n8n](https://docs.n8n.io/hosting/) ou utilisez [n8n Cloud](https://n8n.io/cloud/) pour démarrer en quelques minutes.
</Note>

## De quoi ai-je besoin avant de commencer ?

Pour suivre ce guide, vous avez besoin de deux choses :

* n8n installé (auto-hébergé ou cloud)
* Une clé API Enrow ([obtenez-en une ici](https://app.enrow.io/settings/api-keys))

Chaque requête Enrow est authentifiée avec la clé API dans l'en-tête `x-api-key` — il n'y a pas de flux OAuth ni de jetons bearer. Pour tous les détails, consultez [Authentification](/fr/authentication).

## Comment stocker ma clé API Enrow dans n8n ?

Stockez la clé API une seule fois en tant qu'identifiant **Header Auth** réutilisable afin de ne pas la coller dans chaque node :

1. Dans n8n, ouvrez **Credentials** → **New**
2. Choisissez **Header Auth**
3. Définissez **Name** sur `x-api-key`
4. Définissez **Value** sur votre clé API Enrow
5. Enregistrez l'identifiant (par exemple, nommez-le « Enrow API »)

Vous pouvez désormais référencer cet identifiant depuis n'importe quel node HTTP Request dans vos workflows.

## Comment créer un workflow qui trouve un e-mail unique ?

Le workflow comporte trois parties : un déclencheur pour le lancer, un node HTTP Request qui appelle l'endpoint [Find Single Email](/fr/api-reference/email-finder/find-single), et un node Webhook qui reçoit le résultat lorsque la recherche se termine.

### Étape 1 : Créer un nouveau workflow

1. Ouvrez n8n
2. Cliquez sur **« New Workflow »**
3. Nommez-le « Enrow - Find Email »

### Étape 2 : Ajouter un Manual Trigger

1. Cliquez sur le bouton **« + »**
2. Recherchez **« Manual Trigger »**
3. Ajoutez-le à votre canevas

Le Manual Trigger vous permet d'exécuter le workflow à la demande pendant que vous le testez.

### Étape 3 : Ajouter un node HTTP Request

1. Cliquez sur **« + »** après le Manual Trigger
2. Recherchez **« HTTP Request »**
3. Configurez-le :

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

### Étape 4 : Tester le workflow

1. Cliquez sur **« Execute Workflow »** en haut
2. Vous devriez voir une réponse contenant un `id` de recherche
3. La recherche est traitée de manière asynchrone — l'`id` est ce que vous utiliserez pour récupérer le résultat

### Étape 5 : Recevoir les résultats avec un webhook

Enrow exécute les recherches de manière asynchrone. Ainsi, au lieu de faire du polling, laissez n8n recevoir le résultat automatiquement. L'API Enrow enverra (POST) le résultat à votre URL de webhook une fois la recherche terminée. Consultez [Fonctionnement des webhooks](/fr/how-webhooks-work) pour le flux complet.

1. Ajoutez un node **« Webhook »** à votre canevas

2. Définissez :
   * HTTP Method: `POST`
   * Path: `enrow-email-result`

3. Copiez l'**Production URL** (par ex. `https://your-n8n.com/webhook/enrow-email-result`)

4. Mettez à jour le JSON de votre node HTTP Request pour inclure le webhook dans `settings` :

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

5. Enregistrez et activez le workflow

Désormais, lorsque la recherche se termine, Enrow enverra (POST) le résultat à votre node webhook.

## Puis-je importer un workflow prêt à l'emploi ?

Oui. Copiez le JSON ci-dessous pour démarrer rapidement, puis importez-le dans 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}]]
    }
  }
}
```

Pour importer le workflow :

1. Copiez le JSON ci-dessus
2. Dans n8n, cliquez sur **« ... »** → **« Import from File/URL/String »**
3. Collez le JSON
4. Mettez à jour la clé API dans les identifiants
5. Activez !

## Quelles sont les bonnes pratiques pour n8n + Enrow ?

<AccordionGroup>
  <Accordion title="Stocker la clé API en tant qu'identifiant">
    Créez un identifiant **Header Auth** avec :

    * Name: `x-api-key`
    * Value : votre clé API Enrow

    Réutilisez cet identifiant dans tous vos workflows au lieu de coller la clé API dans chaque node.
  </Accordion>

  <Accordion title="Utiliser les webhooks, pas les nodes Wait">
    Les webhooks sont plus fiables que le polling avec des nodes Wait. Passez toujours le paramètre `settings.webhook` pour qu'Enrow livre le résultat dès que la recherche se termine.
  </Accordion>

  <Accordion title="Gérer les erreurs avec élégance">
    Ajoutez un node **« Error Trigger »** pour capturer et gérer les erreurs de l'API. Consultez [Gestion des erreurs](/fr/error-handling) et [Codes de statut](/fr/status-codes) pour connaître les formats de réponse à attendre.
  </Accordion>

  <Accordion title="Utiliser les endpoints groupés pour plusieurs recherches">
    Si vous traitez de nombreux contacts, utilisez l'endpoint [Find Bulk Emails](/fr/api-reference/email-finder/find-bulk) (jusqu'à 5 000 recherches par lot) au lieu de boucler des requêtes uniques.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Pourquoi est-ce que j'obtiens une erreur Unauthorized ?">
    Un `401 Unauthorized` signifie que la clé API est manquante ou invalide. Vérifiez que l'identifiant **Header Auth** comporte `x-api-key` comme **Name** et votre clé API Enrow valide comme **Value**. Consultez [Authentification](/fr/authentication) pour plus de détails.
  </Accordion>

  <Accordion title="Pourquoi mon webhook ne reçoit-il pas de données ?">
    Tout d'abord, assurez-vous que le workflow est **activé**, et pas seulement enregistré. Confirmez ensuite que l'URL du webhook dans le paramètre `settings.webhook` correspond à l'**Production URL** du node Webhook. Vous pouvez tester l'URL directement avec un outil comme Postman. Consultez [Fonctionnement des webhooks](/fr/how-webhooks-work) pour le flux de livraison.
  </Accordion>

  <Accordion title="Pourquoi est-ce que j'obtiens une erreur Rate Limit Exceeded ?">
    Une erreur de limite de débit signifie que vous avez envoyé trop de requêtes trop rapidement. Ajoutez un node **« Wait »** entre les opérations par lot, ou utilisez les endpoints groupés au lieu de boucler. Consultez [Limites de débit](/fr/rate-limits) pour connaître les limites actuelles.
  </Accordion>

  <Accordion title="Où puis-je obtenir de l'aide ?">
    Pour les questions sur les workflows, utilisez le [Forum communautaire n8n](https://community.n8n.io). Pour les questions sur l'API, contactez le [Support Enrow](https://help.enrow.io).
  </Accordion>
</AccordionGroup>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Email Enrichment" icon="table" href="/fr/playbooks/n8n/email-enrichment-workflow">
    Enrichissez des contacts depuis un tableur dans n8n.
  </Card>

  <Card title="Email Verification" icon="shield-check" href="/fr/playbooks/n8n/lead-verification-workflow">
    Vérifiez des listes d'e-mails de prospects dans un workflow n8n.
  </Card>

  <Card title="Find Single Email" icon="envelope" href="/fr/api-reference/email-finder/find-single">
    Consultez les paramètres de l'endpoint et le format de réponse.
  </Card>

  <Card title="How webhooks work" icon="bell" href="/fr/how-webhooks-work">
    Soyez notifié automatiquement lorsqu'une recherche se termine.
  </Card>
</CardGroup>