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

> Połącz API Enrow z n8n za pomocą Header Auth i zbuduj swój pierwszy workflow wyszukiwania adresów e-mail z webhookami

Ten przewodnik pokazuje, jak połączyć API Enrow z n8n i zbudować pierwszy workflow: pojedyncze wyszukiwanie adresu e-mail, które automatycznie zwraca wynik przez webhook. n8n to narzędzie do automatyzacji workflow, które pozwala łączyć Enrow z setkami innych usług, a można je hostować samodzielnie lub uruchomić w n8n Cloud.

<Note>
  **Nie masz n8n?** [Zainstaluj n8n](https://docs.n8n.io/hosting/) lub skorzystaj z [n8n Cloud](https://n8n.io/cloud/), aby zacząć w kilka minut.
</Note>

## Czego potrzebuję, zanim zacznę?

Aby przejść przez ten przewodnik, potrzebujesz dwóch rzeczy:

* Zainstalowanego n8n (self-hosted lub w chmurze)
* Klucza API Enrow ([pobierz go tutaj](https://app.enrow.io/settings/api-keys))

Każde żądanie do Enrow jest uwierzytelniane kluczem API w nagłówku `x-api-key` — nie ma żadnych przepływów OAuth ani tokenów bearer. Szczegóły znajdziesz w sekcji [Authentication](/pl/authentication).

## Jak przechowywać klucz API Enrow w n8n?

Zapisz klucz API raz jako wielokrotnego użytku poświadczenie **Header Auth**, aby nie wklejać go do każdego węzła:

1. W n8n otwórz **Credentials** → **New**
2. Wybierz **Header Auth**
3. Ustaw **Name** na `x-api-key`
4. Ustaw **Value** na swój klucz API Enrow
5. Zapisz poświadczenie (na przykład nadaj mu nazwę „Enrow API")

Możesz teraz odwoływać się do tego poświadczenia z dowolnego węzła HTTP Request we wszystkich swoich workflow.

## Jak zbudować workflow, który znajduje pojedynczy adres e-mail?

Workflow składa się z trzech części: triggera, który go uruchamia, węzła HTTP Request, który wywołuje endpoint [Find Single Email](/pl/api-reference/email-finder/find-single), oraz węzła Webhook, który odbiera wynik po zakończeniu wyszukiwania.

### Krok 1: Utwórz nowy workflow

1. Otwórz n8n
2. Kliknij **„New Workflow"**
3. Nazwij go „Enrow - Find Email"

### Krok 2: Dodaj Manual Trigger

1. Kliknij przycisk **„+"**
2. Wyszukaj **„Manual Trigger"**
3. Dodaj go do swojego płótna

Manual Trigger pozwala uruchamiać workflow na żądanie podczas testowania.

### Krok 3: Dodaj węzeł HTTP Request

1. Kliknij **„+"** po Manual Trigger
2. Wyszukaj **„HTTP Request"**
3. Skonfiguruj go:

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

### Krok 4: Przetestuj workflow

1. Kliknij **„Execute Workflow"** u góry
2. Powinieneś zobaczyć odpowiedź z `id` wyszukiwania
3. Wyszukiwanie jest przetwarzane asynchronicznie — `id` to wartość, której użyjesz do pobrania wyniku

### Krok 5: Odbieraj wyniki za pomocą webhooka

Enrow wykonuje wyszukiwania asynchronicznie, więc zamiast odpytywania pozwól n8n automatycznie odebrać wynik. API Enrow wyśle wynik metodą POST na Twój adres URL webhooka po zakończeniu wyszukiwania. Pełny przebieg opisano w sekcji [How webhooks work](/pl/how-webhooks-work).

1. Dodaj węzeł **„Webhook"** do swojego płótna

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

3. Skopiuj **Production URL** (np. `https://your-n8n.com/webhook/enrow-email-result`)

4. Zaktualizuj JSON w węźle HTTP Request, dodając webhook do `settings`:

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

5. Zapisz i aktywuj workflow

Teraz po zakończeniu wyszukiwania Enrow wyśle wynik metodą POST do Twojego węzła webhooka.

## Czy mogę zaimportować gotowy workflow?

Tak. Skopiuj poniższy JSON, aby szybko zacząć, a następnie zaimportuj go do 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}]]
    }
  }
}
```

Aby zaimportować workflow:

1. Skopiuj powyższy JSON
2. W n8n kliknij **„..."** → **„Import from File/URL/String"**
3. Wklej JSON
4. Zaktualizuj klucz API w poświadczeniach
5. Aktywuj!

## Jakie są najlepsze praktyki dla n8n + Enrow?

<AccordionGroup>
  <Accordion title="Przechowuj klucz API jako poświadczenie">
    Utwórz poświadczenie **Header Auth** z:

    * Name: `x-api-key`
    * Value: Twój klucz API Enrow

    Używaj tego poświadczenia wielokrotnie w różnych workflow zamiast wklejać klucz API do każdego węzła.
  </Accordion>

  <Accordion title="Używaj webhooków, a nie węzłów Wait">
    Webhooki są bardziej niezawodne niż odpytywanie z użyciem węzłów Wait. Zawsze przekazuj parametr `settings.webhook`, aby Enrow dostarczył wynik natychmiast po zakończeniu wyszukiwania.
  </Accordion>

  <Accordion title="Obsługuj błędy w elegancki sposób">
    Dodaj węzeł **„Error Trigger"**, aby przechwytywać i obsługiwać błędy API. Formaty odpowiedzi, których możesz się spodziewać, opisano w sekcjach [Error handling](/pl/error-handling) i [Status codes](/pl/status-codes).
  </Accordion>

  <Accordion title="Używaj endpointów zbiorczych do wielu wyszukiwań">
    Jeśli przetwarzasz wiele kontaktów, użyj endpointu [Find Bulk Emails](/pl/api-reference/email-finder/find-bulk) (do 5000 wyszukiwań na partię) zamiast zapętlać pojedyncze żądania.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Dlaczego otrzymuję błąd Unauthorized?">
    `401 Unauthorized` oznacza, że klucz API jest brakujący lub nieprawidłowy. Sprawdź, czy poświadczenie **Header Auth** ma `x-api-key` jako **Name** oraz Twój prawidłowy klucz API Enrow jako **Value**. Szczegóły znajdziesz w sekcji [Authentication](/pl/authentication).
  </Accordion>

  <Accordion title="Dlaczego mój webhook nie odbiera danych?">
    Najpierw upewnij się, że workflow jest **aktywowany**, a nie tylko zapisany. Następnie sprawdź, czy adres URL webhooka w parametrze `settings.webhook` odpowiada **Production URL** węzła Webhook. Możesz przetestować adres URL bezpośrednio za pomocą narzędzia takiego jak Postman. Przebieg dostarczania opisano w sekcji [How webhooks work](/pl/how-webhooks-work).
  </Accordion>

  <Accordion title="Dlaczego otrzymuję błąd Rate Limit Exceeded?">
    Błąd limitu zapytań oznacza, że wysłałeś zbyt wiele żądań w zbyt krótkim czasie. Dodaj węzeł **„Wait"** między operacjami wsadowymi lub używaj endpointów zbiorczych zamiast zapętlania. Aktualne limity opisano w sekcji [Rate limits](/pl/rate-limits).
  </Accordion>

  <Accordion title="Gdzie mogę uzyskać pomoc?">
    W sprawie pytań dotyczących workflow skorzystaj z [n8n Community Forum](https://community.n8n.io). W sprawie pytań dotyczących API skontaktuj się z [Enrow Support](https://help.enrow.io).
  </Accordion>
</AccordionGroup>

## Następne kroki

<CardGroup cols={2}>
  <Card title="Wzbogacanie e-maili" icon="table" href="/pl/playbooks/n8n/email-enrichment-workflow">
    Wzbogacaj kontakty z arkusza kalkulacyjnego w n8n.
  </Card>

  <Card title="Weryfikacja e-maili" icon="shield-check" href="/pl/playbooks/n8n/lead-verification-workflow">
    Weryfikuj listy adresów e-mail leadów w workflow n8n.
  </Card>

  <Card title="Find Single Email" icon="envelope" href="/pl/api-reference/email-finder/find-single">
    Zobacz parametry endpointu i format odpowiedzi.
  </Card>

  <Card title="Jak działają webhooki" icon="bell" href="/pl/how-webhooks-work">
    Otrzymuj automatyczne powiadomienia po zakończeniu wyszukiwania.
  </Card>
</CardGroup>